Google スプレッドシートでデータの更新をスケジュールする

このページでは、 Databricks Connector for Google Sheets でデータの自動更新をスケジュールして、インポートしたデータを最新の状態に保つ方法について説明します。 スケジュールされた更新では、保存されたクエリが定期的に実行され、対応するシートが更新されます。

必要条件

  • Databricks Connector for Google Sheets を設定し、Azure Databricks からデータをインポートしました。

Unity カタログ接続を作成する

スケジュールされた更新には、次のものが必要です。

  • Google スプレッドシートのメタストア管理者によって作成された、 databricks_google_connectionという Unity カタログ接続。
  • スケジュールされた更新を作成または管理する必要があるユーザーに付与される、接続に対する USE CONNECTION 特権。
  1. Azure Databricksメタストア管理者として、Google スプレッドシートで Databricks Connector for Google Sheets サイドバーを開きます。
  2. [ 保存されたインポート ] タブをクリックします。
  3. 右上にある予定表をクリックします。
  4. 接続のセットアップをクリックします。

Azure Databricks で接続を共有する

接続が作成されたら、スケジュールされた更新を作成または管理する必要があるユーザーに USE CONNECTION 特権を付与します。 メタストア管理者、または接続に対する MANAGE 特権を持つユーザーは、この特権を付与できます。 接続の管理の詳細については、 Lakehouse フェデレーションの接続の管理を参照してください。

スケジュールを作成する

各インポートは、1 つのスケジュールにのみ割り当てることができます。 既存のインポートの新しいスケジュールを作成するには:

  1. Google スプレッドシートの [Azure Databricks コネクタ] サイドバーで、[Saved imports タブをクリックします。

  2. 予定表アイコンをクリックし、[ 新しいスケジュール] をクリックします。

  3. スケジュールを作成する対象のインポートを選択してください。

  4. スケジュールの名前を入力します。

  5. スケジュールの 頻度 を選択します。

    • Hourly では、更新を実行する各時の何分かを選択します。
    • [ 毎日] で、更新を実行する時刻を選択します。
    • [ 毎週] で、曜日と更新を実行する時間を選択します。

    スケジュールでは、ローカル タイム ゾーンが使用されます。

  6. スケジュールされたクエリに使用する SQL ウェアハウスを選択します。

  7. [ スケジュールの作成] をクリックします。

実行履歴とスケジュールの詳細を表示する

スケジュールされたすべての更新の実行履歴を表示するには、次の操作を行います。

  1. Google スプレッドシートの [Azure Databricks コネクタ] サイドバーで、[Saved imports タブをクリックします。
  2. 予定表アイコンをクリックし、[ 実行履歴の表示] をクリックします。
  3. 特定の実行をクリックして、スケジュールの詳細を表示します。

スケジュールされた更新の実行履歴と構成の詳細を表示するには、次の操作を行います。

  1. [ 実行履歴の表示 ] ウィンドウで、表示するスケジュールの名前を選択します。 [ 最近の実行] に、各実行の状態が表示されます。

  2. 状態アイコンにカーソルを合わせると、実行の 実行 ID、 開始時刻、および 実行状態が表示されます。

    [最近の実行] の実行状態アイコンにカーソルを合わせると、個々の実行の詳細が表示されます

  3. 選択したインポートとスケジュール の構成 を含むスケジュールの詳細を表示するには、[構成の表示] をクリックします。

    • 他のユーザーによって作成されたスケジュールを表示している場合、表示される時刻は作成者のローカル タイム ゾーンの時刻です。

スケジュールされた更新を削除する

スケジュールされた更新を削除するには、次の操作を行います。

  1. Google スプレッドシートの [Azure Databricks コネクタ] サイドバーで、[Saved imports タブをクリックします。
  2. 予定表アイコンをクリックし、[ スケジュールの管理] をクリックします。
  3. 削除するスケジュールを選択します。
  4. [構成の表示] をクリックし、次に [削除] をクリックします。

Troubleshooting

スケジュールされた更新で問題が発生している場合は、Google Sheets のスケジュールと、Azure Databricksの対応する Unity カタログ接続を削除し、スケジュールを再作成します。 Unity カタログ接続の詳細については、 Lakehouse フェデレーションの接続の管理に関するページを参照してください。

制限事項

  • スケジュールされた更新を編集することはできません。 表示または削除できるのは、既存のスケジュールのみです。 スケジュールを変更するには、スケジュールを削除して新しいスケジュールを作成します。
  • スケジュールで使用するクエリを編集しても、スケジュールによって変更が自動的に取得されることはありません。 更新されたクエリ テキストを適用するには、スケジュールを削除して再作成します。
  • ピボット テーブルの更新をスケジュールすることはできません。 Google API は生のクエリ データのみを更新し、クエリ結果スキーマが変更された場合はピボット構成を変更できません。
  • 1 つのスケジュールに最大 20 個のインポートを含めることができます。
  • スケジュールされた更新で使用されるインポートのクエリ テキストには、4,096 文字の制限があります。
  • Last updated on