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

管理者設定 - 接続

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

接続の表示

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

[データベース] タブ

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

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

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

列	説明
名前	`connection` LookML パラメータで使用される、選択した接続の名前。接続をテストすると、Looker で接続名の下にステータスチェックのリストが表示されます。
Database	この接続の使用時に Looker がクエリするデータベースの名前。
スコープ	接続をすべてのプロジェクトで使用できるか、1 つの特定のプロジェクトのみで使用できるか。
SSH サーバー	データベースへの SSH トンネルを作成するために使用される SSH サーバー構成の名前。この列は、Looker インスタンスで [SSH サーバー] タブが有効になっている場合にのみ表示されます。
SSL	SSL 暗号化を使用して Looker とデータベース間を移動するデータを保護しているかどうか（SSL 以外にも安全なオプションがあります）。
Type	データベース接続の SQL 言語。
Actions	接続に対して実行できる操作: 接続のテスト、接続の編集、接続に関するその他の情報の表示、接続の 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 ポートを Looker ですでに使用されている 443 に設定する必要があります。これにより 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 レポートを作成できます。このオプションは、選択したスキーマ名、テーブル名、列数で始まりますが、他の Looker レポートと同様に操作できます。
データベースを表示	このオプションを使用すると、Looker の Explore ページが開き、接続のメタデータに基づいて Looker レポートを作成できます。このオプションは選択したスキーマ名、カタログ名、テーブル数、列数で始まりますが、他の Looker レポートと同様に操作できます。
プロセスを表示	このオプションを使用すると、Looker Explore のページが表示されます。このページでは、この接続で実行中のプロセス、プロセスの状態、実行時間などの情報に基づいて Looker レポートを作成できます。Looker の実行速度が遅い場合や、クエリがまったく実行されていない場合に、原因を特定するのに役立ちます。
PDT イベントログを表示	このオプションを使用すると、Looker の Explore ページが開き、この接続の派生テーブルアクティビティに基づいて Looker レポートを作成できます。利用可能なフィールドの詳細については、永続的な派生テーブルのドキュメントページをご覧ください。