Looker 22.16 のドキュメントを表示しています。最新のドキュメントはこちらをご覧ください。

管理者設定 - 接続

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

接続を表示する

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

[データベース] タブ

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

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

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

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

[SSH サーバー] タブ

[SSH Server] オプションは、インスタンスが Kubernetes インフラストラクチャにデプロイされ、Looker インスタンスに構成する情報を Looker インスタンスに追加する機能が有効になっている場合にのみ使用できます。このオプションが Looker インスタンスで有効になっていない場合に Looker インスタンスを有効にする場合は、Looker アカウントマネージャーに連絡するか、Looker のヘルプセンターでサポートリクエストを開いてください。

Looker では SSH トンネルの作成時に自動的にローカルホストのポートが選択されます。現時点では、ローカルホストのポートを指定することはできません。

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

[SSH サーバー] タブには、追加した SSH サーバー構成のリストが表示され、SSH サーバーへの接続ステータスが示され、各 SSH サーバーを使用してデータベース接続がリストされています。[SSH Servers] タブでは、SSH サーバーへの接続をテストしたり、SSH サーバー構成を追加または編集したりすることもできます。

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

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

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

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

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

既存の SSH サーバー構成を編集するには、目的の SSH サーバーの行のその他メニューをクリックし、[Server Details] を選択します。

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

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

目的の SSH サーバーの行のその他メニューをクリックします。
[Test Connections] を選択します。

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

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

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

目的の SSH サーバーの行のその他メニューをクリックします。
[Add Connection] を選択します。

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

SSH サーバー構成の削除

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

削除する SSH サーバーの行のその他メニューをクリックします。
[サーバーを削除] を選択します。

接続のテスト

Looker を使用すると、既存の接続が適切に機能していることをテストできます。Looker のデータベースへの接続ドキュメントページの説明に従って、接続時に接続をテストすることもできます。

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

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

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

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

その接続の右端の [テスト] をクリックして、単一の接続
ページの上部にある [Test All Connections] ボタンをクリックしてすべての接続

よく寄せられる確認の原因は 2 つあります。

一時スキーマを確認できます。
永続的な派生テーブルを使用できる

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

接続の追加

新しいデータベース接続を追加するには、Looker のデータベースへの接続ドキュメントに記載された手順を行います。

接続の編集

既存の接続を編集するには、各接続の右端にある [Edit] ボタンをクリックします。接続の作成に使用したものと同じページが表示されますが（Looker のデータベースへの接続ドキュメントに記載）、関連情報はすでに入力されています。必要に応じて変更し、[Update Connection] をクリックします。

すべての接続で使用できる操作

接続には、歯車アイコンのプルダウンメニューから各接続の右端までの次のオプションがあります。

オプション	説明
SQL Runner	このオプションでは、適切な接続とスキーマがすでに選択されている Looker の SQL ランナーが表示されます。
探索	このオプションを使用すると、接続用に自動生成される基本的な Explore オプションのリストが表示されます。これらはカスタマイズされたデータモデルに基づいていませんが、接続テーブルの生データを簡単にレポートできます。通常、これはデータの分析を目的としており、モデリングの前にテーブルの内容を把握するために役立ちます。
削除	既存の接続を削除するには、接続の右端にある歯車アイコンをクリックして [Delete] を選択します。削除を確定してもかまいませんが、一度確定すると元に戻すことはできません。接続を誤って削除すると、その接続を使用するクエリが無効になります。ただし、同じ名前で新しい接続を再作成すると、機能が復元されます。

一部の接続で利用できる操作

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

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