PostgreSQL

これらのインストラクションを使用するダイアレクト

このページで説明しているデータベース設定要件は、以下の言語に共通です。

PostgreSQL
Microsoft Azure PostgreSQL
Amazon Aurora PostgreSQL
Amazon RDS for PostgreSQL

Looker には、Amazon RDS for PostgreSQL と Amazon Aurora PostgreSQL のインテグレーションサポートが含まれています。

注: PostgreSQL on Heroku については、Heroku のドキュメントをご覧ください。

Google Cloud SQL for PostgreSQL については、Google Cloud SQL for PostgreSQL の専用ページをご覧ください。

ネットワークトラフィックの暗号化

Looker アプリケーションとデータベース間のネットワークトラフィックを暗号化することが効果的な手法です。セキュアなデータベースアクセスを可能にするドキュメントページに記載されているオプションのいずれかを検討してください。

SSL 暗号化の使用を検討している場合は、PostgreSQL のドキュメントをご覧ください。

ユーザーとセキュリティ

データベースでアクションを実行するには、Looker がデータベース上のユーザーアカウントを持っている必要があります。

Looker が使用するデータベースユーザーを構成するには、データベースで次の操作を行います。

データベースユーザーとパスワードを作成します。
```
CREATE USER USERNAME WITH ENCRYPTED PASSWORD 'PASSWORD';
```

Looker がデータベースでアクションを実行できるように、データベースユーザーに権限を付与します。

GRANT CONNECT ON DATABASE DATABASE_NAME to USERNAME;
\c DATABASE_NAME
GRANT SELECT ON ALL SEQUENCES IN SCHEMA public TO USERNAME;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO USERNAME;

public 以外のスキーマを使用している場合は、次のコマンドを実行して Looker に使用権限を付与します。
```
GRANT USAGE ON SCHEMA SCHEMA_NAME TO USERNAME;
```

public スキーマに今後追加するテーブルを Looker ユーザーが確実に利用できるようにするには、次のコマンドを実行します。

ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON tables TO USERNAME;
ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON sequences TO USERNAME;

ご利用の設定によっては、上記のコマンドを変更する必要がある場合があります。Looker ユーザーが今後の権限を必要とするテーブルを別のユーザーまたはロールが作成している場合、Looker ユーザーの権限の付与を適用する対象のロールまたはユーザーを指定する必要があります。

ALTER DEFAULT PRIVILEGES FOR USER ANOTHER_USERNAME IN SCHEMA SCHEMA_NAME GRANT SELECT ON tables TO USERNAME;
ALTER DEFAULT PRIVILEGES FOR ROLE TARGET_ROLE IN SCHEMA SCHEMA_NAME GRANT SELECT ON sequences TO USERNAME;

たとえば、web_app ユーザーがテーブルを作成し、looker ユーザーがそれらのテーブルを使用できるようにするには、GRANT ステートメントを実行して、looker ユーザーに web_app ユーザーにより作成されたそのテーブルに対する権限を付与する必要があります。この場合の対象ロールまたはユーザーは web_app ユーザーです。つまり、web_app によって作成されたテーブルに対する権限を変更して、looker ユーザーにテーブルの読み取り権限を付与します。以下に例を示します。

ALTER DEFAULT PRIVILEGES FOR USER web_app IN SCHEMA public GRANT SELECT ON tables TO looker;

詳細については、PostgreSQL のウェブサイトの ALTER DEFAULT PRIVILEGES をご覧ください。

一時的スキーマ設定

自己ホスト型Postgres

Lookerユーザーによって所有されるスキーマを作成します。

CREATE SCHEMA SCHEMA_NAME AUTHORIZATION USERNAME;

Amazon RDS上のPostgres

スクラッチスキーマを作成します。

CREATE SCHEMA SCHEMA_NAME;

スクラッチスキーマの所有権をLookerユーザーに変更します。

ALTER SCHEMA SCHEMA_NAME OWNER TO USERNAME;

`search_path` の設定

Looker をデータベースに接続する前に、Looker SQL Runner がデータベースから特定のメタデータを取得するために使用できる適切な search_path を設定する必要があります。

ALTER USER USERNAME SET search_path TO '$user',SCHEMA_NAME,SCHEMA_NAME_2,SCHEMA_NAME_3
                                                            ^^^^^^^^^^^^^^^^^^
                                                            ^^^^^^^^^^^^^^^^^^
                                             include a comma-separated list of
                                            all schemas that you'll use with Looker

データベースへの Looker 接続の作成

Looker からデータベースへの接続を作成するには、次の手順を行います。

次のいずれかの方法で [データベースを Looker に接続する] ページを開きます。
- [メインメニュー] アイコンをクリックして [管理] を選択し、[管理] パネルの [データベース] セクションで [接続] を選択します。[接続] ページで、[接続を追加] ボタンをクリックします。
- [Create] ボタンを [ナビゲーションメニュー] でクリックし、[Connection] メニュー項目を選択します。
[言語] プルダウンメニューから、データベース言語名を選択します。
- Microsoft Azure PostgreSQL の場合は、[Microsoft Azure PostgreSQL] を選択します。
- PostgreSQL の場合は、PostgreSQL のバージョンに応じて [PostgreSQL 9.5 以降] または [PostgreSQL 9.5 より前] を選択します。
- Amazon RDS for PostgreSQL と Amazon Aurora PostgreSQL の場合は、[PostgreSQL 9.5 以降] を選択します。
注: Looker（Google Cloud コア）インスタンスを使用していて、[言語] プルダウンメニューに使用している言語が表示されない場合は、Looker（Google Cloud コア）のドキュメントを参照して、その言語が Looker（Google Cloud コア）インスタンスでサポートされていることを確認してください。
接続の詳細を入力します。設定の大部分は、ほとんどのデータベース言語に共通するものです。詳細については、Looker をデータベースに接続するのドキュメントページをご覧ください。
接続が成功したことを確認するには、[テスト] をクリックします。トラブルシューティング情報については、データベース接続のテストのドキュメントページをご覧ください。
これらの設定を保存するには、[接続] をクリックします。

サポートされている JDBC パラメータ

PostgreSQL の場合、Looker は接続の [**その他の JDBC パラメータ**] フィールドで次の JDBC パラメータをサポートしています。これらのパラメータについては、データベースのドキュメントをご覧ください。

allowEncodingChanges
ApplicationName
assumeMinServerVersion
binaryTransfer
binaryTransferDisable
binaryTransferEnable
cancelSignalTimeout
connectTimeout
currentSchema
databaseMetadataCacheFields
defaultRowFetchSize
escapeSyntaxCallMode
gssEncMode
hostRecheckSeconds
jaasApplicationName
jaasLogin
kerberosServerName
loadBalanceHosts
loginTimeout
logServerErrorDetail
options
password
preferQueryMode
preparedStatementCacheQueries
prepareThreshold
queryTimeout
readOnly
reWriteBatchedInserts
socketTimeout
ssl
sslfactory
sslhostnameverifier
sslmode
sslNegotiation
sslpassword
sslpasswordcallback
stringtype
targetServerType
tcpKeepAlive
unknownLength
user

機能のサポート

一部の機能については、Looker でサポートするには、データベース言語が同じ機能に対応している必要があります。

PostgreSQL 9.5 以降では、Looker 26.6 の時点で、次の機能がサポートされています。

機能	サポート対象
Looker（Google Cloud コア）
対称集計
派生テーブル
永続的な SQL 派生テーブル
永続的なネイティブ派生テーブル
安定したビュー
クエリの強制終了
SQL ベースのピボット
タイムゾーン
SSL
Subtotals
JDBC の追加パラメータ
大文字と小文字の区別
ロケーションタイプ
リストの種類
パーセンタイル
個別のパーセンタイル
SQL Runner の表示プロセス
SQL Runner の説明テーブル
SQL Runner インデックスを表示
SQL Runner Select 10
SQL Runner の数
SQL の説明
OAuth 2.0 認証情報
コンテキストコメント
接続プーリング
HLL スケッチ
集計テーブルの自動認識
増分 PDT
ミリ秒
マイクロ秒
マテリアライズドビュー
前の期間との比較
Approximate Count Distinct
カスタムカレンダー

Microsoft Azure PostgreSQL では、Looker 26.6 の時点で、次の機能がサポートされています。

機能	サポート対象
Looker（Google Cloud コア）
対称集計
派生テーブル
永続的な SQL 派生テーブル
永続的なネイティブ派生テーブル
安定したビュー
クエリの強制終了
SQL ベースのピボット
タイムゾーン
SSL
Subtotals
JDBC の追加パラメータ
大文字と小文字の区別
ロケーションタイプ
リストの種類
パーセンタイル
個別のパーセンタイル
SQL Runner の表示プロセス
SQL Runner の説明テーブル
SQL Runner インデックスを表示
SQL Runner Select 10
SQL Runner の数
SQL の説明
OAuth 2.0 認証情報
コンテキストコメント
接続プーリング
HLL スケッチ
集計テーブルの自動認識
増分 PDT
ミリ秒
マイクロ秒
マテリアライズドビュー
前の期間との比較
Approximate Count Distinct
カスタムカレンダー