表示されているのは Looker のドキュメントです。Looker Studio のドキュメントについては、https://support.google.com/looker-studio をご覧ください。

管理者設定 - 接続

[接続] ページにアクセスするには、[管理者] メニューを開き、[データベース] で [接続] を選択します。

接続の表示

[接続] ページでは、データベース接続とネットワークトラフィックの許可に必要な IP アドレスを確認できます。インスタンスで新しいデータベースを作成する機能が有効になっている場合は、新しい接続を追加することもできます。

[データベース] タブ

[データベース] タブには、定義したデータベース接続に関する基本情報が表示されます。また、インスタンスで新しいデータベースの作成機能が有効になっている場合は、作成した Looker 管理の接続も表示されます。[データベース] タブで、これらの接続のステータスをテストして構成を編集することもできます。

[パブリック IP アドレス] をクリックすると、Looker インスタンスからのネットワークトラフィックを許可するために必要な IP アドレスのリストを表示できます。Looker からのすべてのネットワークトラフィックは、ご使用の Looker インスタンスがホストされるリージョンに基づいて、一覧表示された IP アドレスの1つから発信されます。これらの IP アドレスと他の信頼できる IP アドレス以外からのデータベースへのトラフィックを禁止することで、データアクセスを制限できます。

次の表に、[データベース] タブの要素を示します。

列	説明
名前	`connection` LookML パラメータで使用される、ユーザーが選択した接続の名前。接続をテストすると、Looker は接続名の下にステータスチェックのリストを表示します。
データベース	この接続を使用するときに Looker がクエリを実行するデータベースの名前。
スコープ	接続をすべてのプロジェクトで使用できるか、1 つのプロジェクトのみで使用できるか。
SSH サーバー	データベースへの SSH トンネルの作成に使用される SSH サーバー構成の名前。この列は、Looker インスタンスで [SSH サーバー] タブが有効になっている場合にのみ表示されます。
SSL	Looker とデータベース間で転送されるデータを保護するために SSL 暗号化を使用するかどうか（SSL 以外にも他の安全なオプションがあります）。
タイプ	データベース接続の SQL 言語。
アクション	接続に対して実行できる操作: 接続のテスト、接続の編集、接続に関するその他の情報の表示、接続の Explore へのリンクのリストへの移動、または接続の削除。インスタンスで新しいデータベースの作成機能が有効になっている場合は、Looker 管理の接続に追加のデータソースからデータを追加することもできます。

[SSH サーバー] タブ

[SSH Server] オプションは、インスタンスが Kubernetes インフラストラクチャにデプロイされており、Looker インスタンスに SSH サーバー設定情報を追加する機能が有効になっている場合に限り利用できます。このオプションが Looker インスタンスで有効になっておらず、有効にしたい場合は、Google Cloud セールススペシャリストにお問い合わせいただくか、サポートリクエストを開いてください。

Looker では、SSH トンネルを作成する際、localhost ポートが自動的に選択されます。localhost ポートは指定できません。

PrestoDB または Trino データベースへの SSH 接続では、追加のデータベース構成が必要になる場合があります。SSL が有効になっている場合、PrestoDB または Trino データベースはデフォルトでポート 443 でリッスンします。SSH トンネルを確立するには、Looker で localhost ポートを 443 に設定する必要があります。このポートはすでに Looker で使用されています。これにより SSH トンネルの設定が失敗します。この問題を解決するには、SSL が有効になっているときにポート 443 以外のポートをリッスンするように PrestoDB または Trino データベースを構成します。

[SSH サーバー] タブには、追加した SSH サーバー構成のリスト、SSH サーバーへの接続ステータス、各 SSH サーバーを使用したデータベース接続が一覧表示されます。[SSH サーバー] タブから、SSH サーバーへの接続をテストし、SSH サーバー構成を追加または編集します。

次の表に、[SSH Sｓーバー] タブの要素を示します。

列	説明
サーバー名	データベースへの接続に使用される、選択した SSH サーバー構成の名前。
接続	SSH サーバーに接続するデータベース接続のリスト。データベース接続をクリックすると、そのデータベース接続の [接続を編集] ページが開きます。
その他オプションメニュー	SSH サーバー構成に対して実行できる操作: SSH サーバーへの接続のテスト、SSH サーバーへのデータベース接続の追加、SSH サーバー構成の編集、または SSH サーバー構成の削除。

SSH サーバー構成の追加または編集

新しい SSH サーバー構成を追加するには:

[SSH サーバー] タブで、[サーバーを追加] をクリックします。
右上の [名前のないサーバー] フィールドに、SSH サーバー構成の名前を入力します。
[鍵をダウンロード] をクリックして、公開鍵をテキストファイルにダウンロードします。このファイルを保存して、後で使用できるようにしてください。
[サーバーのユーザー名] に、Looker が SSH サーバーに接続する際に使用するユーザー名を入力します。
[サーバーの IP アドレスまたはホスト名] フィールドに、SSH サーバーの IP アドレスまたはホスト名を入力します。
[サーバーポート] フィールドに、SSH サーバーへの接続に使用するポート番号を入力します。
ダウンロードした公開鍵を SSH サーバー上の承認済み鍵ファイルに追加します。詳細と例については、SSH サーバーの使用のドキュメントページをご覧ください。
Looker が SSH サーバーに接続できるように、SSH サーバーで適切な Looker IP アドレスが許可リストに追加されていることを確認します。
[テストとフィンガープリントのリクエスト] をクリックして、SSH サーバーへの接続を確認します。
新しい SSH 構成を表示します。この画面で、公開鍵のダウンロードまたは表示、SSH サーバー構成の一意のフィンガープリントの表示も行えます。

既存の SSH サーバー構成を編集するには、選択中の SSH サーバーの行にある [オプション] メニュー（3 つの点のアイコン）をクリックして、[サーバーの詳細] を選択します。

SSH サーバーへの接続のテスト

SSH サーバーへのすべてのデータベース接続をテストするには:

選択した SSH サーバーの行にある [オプション] メニュー（3 つの点のアイコン）をクリックします。
[接続をテスト] を選択します。

Looker は、その SSH サーバーを使用してすべてのデータベース接続をテストし、接続テストに合格したサーバー名とすべての接続の横に緑色のチェックマークを表示します。赤色の感嘆符アイコンは、接続がテストに失敗したことを示します。

SSH サーバーへのデータベース接続の追加

SSH サーバーを使用して新しいデータベース接続を追加するには:

選択した SSH サーバーの行にある [オプション] メニュー（3 つの点のアイコン）をクリックします。
[接続を追加] を選択します。

Looker では [接続設定] ページが表示され、SSH サーバーが [SSH サーバー] フィールドに一覧表示されます。

SSH サーバー構成の削除

SSH サーバー構成を削除するには:

削除する SSH サーバーの行にある [オプション] メニュー（3 つの点のアイコン）をクリックします。
[サーバーを削除] を選択します。

接続のテスト

Looker では、既存の接続をテストして、正常に機能していることを確認できます。Looker をデータベースに接続するのドキュメントページで説明されているように、接続を追加するときにテストすることもできます。

各接続テストには、Looker がデータベース接続を正常に使用できるかどうかを示すステータスチェックのリストが含まれています。

潜在的な問題は黄色で、エラーは赤色で表示されます。接続が「合格」すると、緑色で表示されます。

OAuth を使用するデータベース接続（Snowflake や Google BigQuery など）には、ユーザーのログインが必要です。これらの接続のいずれかをテストするときに OAuth ユーザーアカウントにログインしていない場合、Looker には [ログイン] リンクとともに警告が表示されます。このリンクをクリックして、OAuth資格情報を入力するか、またはLookerによるOAuthアカウント情報へのアクセスを許可します。

次のステータスを確認できます。

接続の右側にある [テスト] をクリックして 1 つの接続を表示
ページの上部にある [すべての接続をテスト] ボタンをクリックしてすべての接続を表示

よくある誤解の原因は次の 2 つのチェックです。

一時スキーマを見つけることができる
永続的な派生テーブルを使用できる

これらのチェックは、Looker が機能するために合格する必要はありません。ただし、永続的な派生テーブルを使用するためには、これらは合格している必要があり、このテーブルは非常に価値のあるモデリング機能です。

接続の追加

新しいデータベース接続を追加するには、Looker をデータベースに接続するのドキュメントページの手順に沿って操作します。

接続の編集

既存の接続を編集するには、[管理] メニューを選択して [接続] ページを開き、[データベース] で [接続] を選択します。接続の [編集] ボタンをクリックします。接続の作成に使用したページ（Looker をデータベースに接続するのドキュメントページで説明）が表示されますが、関連情報はすでに入力されています。必要な変更を行い、[接続を更新] をクリックします。

すべての接続で利用可能なアクション

すべての接続では、接続の右端にある歯車のプルダウンメニューから次のオプションを選択できます。

オプション	説明
SQL Runner	このオプションを選択すると、適切な接続とスキーマがすでに選択された状態で Looker の SQL Runner が開きます。
探索	このオプションでは、接続用の自動生成された Explore オプションのリストが表示されます。これらはカスタマイズされたデータモデルに基づくものではありませんが、接続のテーブル内の元データに関する簡単なレポートを作成できます。これは通常、実際のデータ分析ではなく、モデリング前にテーブルの内容を把握する場合にのみ役立ちます。
削除	既存の接続を削除するには、接続の右端にある歯車のプルダウンメニューをクリックし、[削除] を選択します。削除の確認を求めるメッセージが表示されますが、削除を確定すると元に戻すことはできません。接続を誤って削除すると、その接続を使用しているクエリが無効になります。ただし、同じ名前で新しい接続を再作成すると、機能は復元されます。

一部の接続に対して利用可能なアクション

接続言語によっては、接続の右側にある歯車のプルダウンメニューに、次の追加オプションが表示される場合があります。

オプション	説明
テーブルを表示	このオプションを使用すると、Looker の Explore ページが開き、接続のメタデータに基づいて Looker Explore クエリを作成できます。このオプションは、選択したスキーマ名、テーブル名、列数で始まりますが、他の Looker Explore と同様に操作できます。
データベースを表示	このオプションを使用すると、Looker の Explore ページが開き、接続のメタデータに基づいて Looker Explore クエリを作成できます。このオプションは選択したスキーマ名、カタログ名、テーブル数、列数で始まりますが、他の Looker Explore と同様に操作できます。
プロセスを表示	このオプションを使用すると、Looker Explore のページが表示されます。このページでは、この接続で実行中のプロセス、プロセスの状態、実行時間などの情報に基づいて Looker Explore クエリを作成できます。Looker の実行速度が遅い場合や、クエリがまったく実行されていない場合に、原因を特定するのに役立ちます。
PDT イベントログを表示	このオプションを使用すると、Looker の Explore ページが開き、この接続の派生テーブルアクティビティに基づいて Looker Explore クエリを作成できます。利用可能なフィールドの詳細については、永続的な派生テーブルのドキュメントページをご覧ください。