[接続] ページにアクセスするには、[管理者] メニューを開き、[データベース] で [接続] を選択します。
接続の表示
[接続] ページでは、データベース接続とネットワーク トラフィックの許可に必要な 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 Ssーバー] タブの要素を示します。
列 | 説明 |
---|---|
サーバー名 | データベースへの接続に使用される、選択した 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 レポートを作成できます。利用可能なフィールドの詳細については、永続的な派生テーブルのドキュメント ページをご覧ください。 |