Google スプレッドシートから Databricks に接続する

備考

プレビュー

この機能は パブリック プレビュー段階です。

このページでは 、Google スプレッドシート用の Databricks コネクタ を使用して Google スプレッドシートから Databricks に接続する方法について説明します。Databricks コネクタは、Google スプレッドシート内から Databricks データをクエリし、さらなる分析を可能にします。

始める前に

• Databricks ワークスペースを作成します。ワークスペースを作成するを参照してください。
• Databricks SQL ウェアハウスを作成します。SQLウェアハウスを作成するを参照してください。
• Google スプレッドシートにアクセスできる。
• Databricks Connector for Google スプレッドシートをインストールします。
• Databricks ワークスペースで IP アクセス リストが有効になっている場合、アカウント管理者は Google Cloud IP リストを許可リストに追加する必要があります。
  • IP アクセスリストの詳細については、「 アカウントコンソールの IP アクセスリストの設定」を参照してください。
  • Google クラウドの IP リストについては、この IP リストを参照してください。

Databricks Workspaceに接続する

まず Databricks ワークスペースに接続し、Google スプレッドシート用の Databricks コネクタを使用して Databricks から Google スプレッドシートにデータをインポートします。

1. Google スプレッドシートで、 [拡張機能] > [Databricks コネクタ] > [サイドバーの起動] を選択してコネクタを開きます。

   

2. ログイン ダイアログで、Databricks ワークスペースの URL を入力します。ワークスペース URL を見つける方法については、 ワークスペース オブジェクトの識別子を取得するを参照してください。

   • ワークスペース URL の形式は次のとおりです: https://<instance-name>.<number>.gcp.databricks.com 。

3. [ サインイン ] をクリックします。

4. ダイアログが表示され、サインインを求めるか、ログイン ステータスが表示されます。

5. ログイン後、使用するSQLウェアハウスを選択できます。 Databricks コネクタ サイドバーの [データ] タブで、コネクタ サイドバーの右上にある円をクリックし、希望する Databricks SQL ウェアハウスを選択して、Databricks SQL ウェアハウスを選択します。コネクタは、選択したSQLウェアハウスを起動します。

   

Google スプレッドシート用の Databricks コネクタを使用する

Google Sheets 用の Databricks コネクタは、Unity Catalog でアクセスできるデータに対してクエリを実行し、そのデータを Google Sheets にインポートします。コネクタはすべてのクエリを自動的にインポートとして保存します。Google スプレッドシートでは、結果を更新したり、既存のクエリを再利用したり、データのソースを追跡したりできます。

データがインポートされると、クエリがシートに関連付けられます。シート名を変更するとマッピングが壊れます。名前の変更を処理する方法については、 「制限事項」を参照してください。

重要

クエリ実行は 3 分後にタイムアウトします。クエリがこの制限を超えると、自動的にキャンセルされます。結果セットが大きい場合、最初の 1,000 行が直ちに書き込まれ、残りのデータは段階的に取得されます。データの取得が中断された場合、部分的な結果がシートに残りますが、クエリを再実行することでクリアできます。

インポート方法を選択する

Databricks からデータをインポートするには、次のいずれかの方法を選択します。

Select a table

Databricks のテーブルからデータをインポートするには:

1. コネクタのサイドバーで、 インポート方法 として データの選択を 選択します。

2. [カタログ] の下で、カタログ、スキーマ、およびテーブルのドロップダウン メニューを使用して、インポートするテーブルを検索します。

3. 必要に応じて、 アセット名 を更新してこのインポートの名前を変更します。

4. オプションで、 [フィールド] で、含める列または除外する列を選択します。

5. オプションでピボット テーブルとしてインポートすることもできます。

6. フィルターを追加するには、 [フィルター] の下の [+ フィルター] をクリックします。フィルターを適用する 列 と フィルター タイプ を選択します。

7. 必要に応じて、 「行数を制限する」 をチェックして、インポートする行数の制限を設定します。

8. [詳細オプション] で、クエリ結果を新しいシートに保存するか、現在のシートに保存するかを選択します。

   • 現在のシートを選択した場合は、データの追加を開始するセルを指定します。

9. シートにデータを入力するには、 [保存してインポート] をクリックします。

Write a SQL query

新しい SQL クエリを記述するには:

1. コネクタ サイドバーの [インポート方法] で、 [新しいクエリの作成] を 選択します。

2. Databricks では、クエリを識別できるように名前を入力することをお勧めします。

3. カタログ、スキーマ、テーブルを参照できます。

4. クエリ テキスト に SQL クエリを入力します。

5. オプションでクエリを追加できます。

6. [詳細オプション] で、クエリ結果を新しいシートに保存するか、現在のシートに保存するかを選択します。

   • 現在のシートを選択した場合は、データの追加を開始するセルを指定します。

7. [保存してインポート] をクリックしてクエリを実行し、シートに入力します。

重要

「データの選択」を使用してUnity Catalogメトリクス ビューをインポートする場合、 Unity Catalogメトリクスはピボットされたデータを表すため、ビューはピボット テーブルとしてのみインポートできます。

クエリの追加 (オプション)

SQLクエリにクエリを追加するには:

1. クエリに:parameter_nameの形式のクエリが少なくとも 1 つ含まれていることを確認してください。 クエリのパラメーターの詳細については、 クエリのパラメーターの操作を参照してください。

2. [+追加]を クリックします。

3. 最初のボックスにパラメーターを入力します。 パラメーター名がクエリ エディターに入力したものと一致していることを確認してください。

4. 2 番目のボックスに、シート名の後の感嘆符を含めて、シート名の値のセル位置を入力します。

5. さらにクエリを追加するには、 [+ 追加] を再度クリックします。

   たとえば、次のクエリには、シートsheet_1セル H1 で定義されているクエリ パラメーター:trip_distanceが含まれています。

   

ピボットテーブルとしてインポート（オプション）

データをピボット テーブルとしてインポートするには:

1. データをインポートするときは、 ピボット テーブル を選択します。
2. [ピボット構成] で、ピボット テーブルのディメンションの 行 と 列 を選択します。
3. 集計する値を指定します。 [+ 値の追加] をクリックし、列と集計方法を選択します。
4. 必要に応じて、 「+ フィルターを追加」を クリックして 列 と フィルターの種類 を選択し、フィルターを追加します。
5. [保存してインポート] をクリックして、結果をピボット テーブルとしてインポートします。インポート ピボット テーブルは新しいシートに自動的にインポートされます。

インポートしたデータの管理

Databricks からインポートしたデータを管理するには:

1. コネクタ サイドバーの [インポート] タブを選択します。
2. インポートを更新するには、クエリ名の横にある更新アイコンをクリックします。
3. インポートが接続されているシートを確認するには、 > クエリ名の横にあるシートに移動します 。
4. インポートを編集するには、クエリ名の横にある > [編集] をクリックします。
5. インポートを削除するには、クエリ名の横にある > [削除] をクリックします。これにより、Google スプレッドシートにインポートされたデータではなく、クエリが削除されます。インポートしたデータは手動で削除する必要があります。

Databricksワークスペースの変更

接続している Databricks ワークスペースを変更するには:

1. 拡張機能 > Databricks コネクタ > ワークスペースの変更を 選択します。
2. 新しいワークスペースの URL を入力し、ワークスペースに認証します。

共有の影響

アドオンは、Google スプレッドシートを共有する機能には影響しません。ただし、ファイルを共有する方法によって、受信者がアドオンを使用して実行できるアクションが影響を受けます。

• 閲覧者またはコメント投稿者の役割を持つ受信者はアドオンにアクセスできません。
• 編集者の役割と同等のデータアセットアクセス権を持つ受信者は、Google アカウントでアドオンを使用できます。所有者と同じようにコネクタを使用できます。
• 編集者ロールを持ち、基礎となるリソースへの同じアクセス権を持つ受信者は、同じ Databricks ワークスペースにログインしている場合、インポートを更新できます。

制限事項

• 既存のインポートに添付されているシートの名前を変更したり削除したりすると、インポートを更新できなくなります。これを修正するには、次の いずれか を実行します。

  • まったく同じ名前でシートを再作成します。
  • ソースとして クエリを選択 を選択し、インポートを再利用して、 新規として保存 をクリックして、新しいインポートを作成します。

• 2 つのクエリが同じ範囲または重複する範囲にマップされている場合、アドオンは最後に実行されたクエリの結果を表示します。これにより、以前にインポートされたデータが上書きされます。