メインコンテンツまでスキップ
に最終更新

Workivaからデータを取り込む

備考

ベータ版

この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。

このページでは、Lakeflow Connectを使用して管理されたWorkiva取り込みパイプラインを作成する方法について説明します。

要件​

  • 取り込みパイプラインを作成するには、まず次の要件を満たす必要があります。

    • ワークスペースでUnity Catalogが有効になっている必要があります。

    • ワークスペースで Serverless コンピュートを有効にする必要があります。See Serverless コンピュートの要件.

    • 新しい接続を作成するには、メタストアに対する CREATE CONNECTION 権限が必要です。Unity Catalog での権限の管理を参照してください。

      コネクタが UI ベースのパイプライン オーサリングをサポートしている場合、管理者はこのページのステップを完了することで、接続とパイプラインを同時に作成できます。 ただし、パイプラインを作成するユーザーが API ベースのパイプライン オーサリングを使用している場合、または管理者以外のユーザーである場合、管理者はまずカタログ エクスプローラーで接続を作成する必要があります。 「管理対象取り込みソースへの接続」を参照してください。

    • 既存の接続を使用するには、接続オブジェクトに対する USE CONNECTION 権限または ALL PRIVILEGES 権限が必要です。

    • ターゲットカタログに対するUSE CATALOG権限が必要です。

    • 既存のスキーマに対する USE SCHEMA 権限と CREATE TABLE 権限、またはターゲットカタログに対する CREATE SCHEMA 権限が必要です。

  • Workiva から取り込むには、まず Databricks から認証を構成し、接続を作成してください。「Workiva への認証の構成」および「Workiva 接続の作成」を参照してください。

取り込みパイプラインを作成​

Workiva コネクタでは、default ソーススキーマの下で、activities、users、roles の 3 つのソーステーブルを利用できます。詳細については、サポートされているソーステーブルを参照してください。

  1. Databricksワークスペースのサイドバーで、 データ取り込み をクリックします。
  2. データの追加 ページの Databricks コネクタ で、 Workiva をクリックします。
  3. 取り込みウィザードの 接続 ページで、Workiva の認証情報を保存している接続を選択します。メタストアに対する CREATE CONNECTION 特権がある場合は、 プラスアイコン。 接続の作成 をクリックして、Workiva への認証の設定の認証情報を使用して接続を作成します。
  4. 次へ をクリックします。
  5. インジェスト設定 ページで、パイプラインの名前を入力します。
  6. イベントLogsの書き込み先となるカタログとスキーマを選択します。カタログに対するUSE CATALOG権限とCREATE SCHEMA権限がある場合は、ドロップダウンメニューの プラスアイコン。 スキーマを作成 をクリックしてスキーマを作成します。
  7. パイプラインの作成および続行 をクリックします。
  8. ソース ページで、取り込むテーブル（activities、users、roles）を選択します。
  9. 保存して続行 をクリックします。
  10. 宛先 ページで、データをロードするカタログとスキーマを選択します。カタログに対する USE CATALOG 権限と CREATE SCHEMA 権限がある場合は、ドロップダウンメニューの プラスアイコン。 スキーマの作成 をクリックしてスキーマを作成します。
  11. 保存して続行 をクリックします。
  12. (オプション) スケジュールと通知 ページで、 プラスアイコン。 スケジュールの作成 をクリックします。宛先テーブルを更新する頻度を設定します。
  13. （オプション） プラスアイコン。 通知の追加 をクリックして、パイプライン操作の成功または失敗に関するEメール通知を設定します。
  14. パイプラインの保存と実行 をクリックします。

例​

Workivaコネクタは、defaultソーススキーマ内のactivities、users、およびrolesテーブルを利用可能にします。詳細については、サポートされているソーステーブルを参照してください。

Workivaテーブルを取り込む​

次のパイプライン定義ファイルは、3 つの Workiva テーブルすべてを取り込みます：

YAML
resources:
  pipelines:
    workiva_pipeline:
      name: workiva_pipeline
      catalog: 'main'
      target: 'workiva_data'
      ingestion_definition:
        connection_name: workiva_connection
        objects:
          - table:
              source_schema: 'default'
              source_table: 'activities'
              destination_catalog: 'main'
              destination_schema: 'workiva_data'
              destination_table: 'activities'
          - table:
              source_schema: 'default'
              source_table: 'users'
              destination_catalog: 'main'
              destination_schema: 'workiva_data'
              destination_table: 'users'
          - table:
              source_schema: 'default'
              source_table: 'roles'
              destination_catalog: 'main'
              destination_schema: 'workiva_data'
              destination_table: 'roles'

特定の開始日時からアクティビティを取り込む​

activities テーブルは、オプションの start_datetime コネクタオプションを受け入れます。これは、初回同期バックフィルウィンドウの起動を設定する UTC ISO-8601 timestamp です。省略すると、過去365日分がバックフィルされます。activities テーブルのみがこのオプションを受け入れます。詳細については、コネクタオプションを参照してください。

YAML
resources:
  pipelines:
    workiva_pipeline:
      name: workiva_pipeline
      catalog: 'main'
      target: 'workiva_data'
      ingestion_definition:
        connection_name: workiva_connection
        objects:
          - table:
              source_schema: 'default'
              source_table: 'activities'
              destination_catalog: 'main'
              destination_schema: 'workiva_data'
              destination_table: 'activities'
              connector_options:
                api_source_connector_options:
                  options:
                    start_datetime: '<start-datetime>'

宣言型オートメーションバンドルのジョブ定義ファイル​

以下は、宣言型オートメーションバンドルで使用するジョブ定義ファイルの例です。ジョブは毎日実行されます。

YAML
resources:
  jobs:
    workiva_job:
      name: workiva_job
      schedule:
        quartz_cron_expression: '0 0 0 * * ?'
        timezone_id: 'UTC'
      tasks:
        - task_key: workiva_ingestion
          pipeline_task:
            pipeline_id: ${resources.pipelines.workiva_pipeline.id}

一般的なパターン​

高度なパイプライン構成については、「マネージド取り込みパイプラインの一般的なパターン」を参照してください。

次のステップ​

パイプラインの起動、スケジュール、アラートの設定を行います。一般的なパイプラインのメンテナンス タスクを参照してください。

その他のリソース​

このページの見出し