メインコンテンツまでスキップ

Zoho CRMからデータを取り込む

備考

ベータ版

この機能はベータ版です。使用するには、ワークスペース管理者は プレビュー ページから Zoho CRM向けLakeflow Connect を有効にする必要があります。Databricksのプレビューを管理を参照してください。

このページでは、Lakeflow Connect を使用してマネージド Zoho CRM インジェストパイプラインを作成する方法を示します。

要件​

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

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

    • Serverless コンピュートがワークスペースで有効になっている必要があります。Serverless コンピュートの要件を参照してください。

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

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

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

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

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

  • Zoho CRMから取り込むには、まずDatabricksからの認証を設定し、接続を作成します。Zoho CRMへの認証の設定とZoho CRM接続の作成を参照してください。

コネクターのオプション​

source_configurations でパイプラインスコープのオプションを設定します。使用例については、例を参照してください。

オプション

スコープ

必須

適用対象

説明

start_datetime

パイプライン

はい

すべての増分テーブル

データ取り込みを開始する最も早い日時(yyyy-MM-ddTHH:mm:ssXXX形式、例:2024-01-01T00:00:00+00:00)。各テーブルの初回同期にのみ適用されます。以降の同期は、保存されたカーソルから再開されます。

オプション

スコープ

必須

適用対象

説明

start_datetime

パイプライン

はい

すべての増分テーブル

データ取り込みを開始する最も早い日時(yyyy-MM-ddTHH:mm:ssXXX形式、例:2024-01-01T00:00:00+00:00)。各テーブルの初回同期にのみ適用されます。以降の同期は、保存されたカーソルから再開されます。

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

サポートされているソーステーブルのリストについては、「サポートされているソーステーブル」を参照してください。

  1. Databricksワークスペースのサイドバーで、 データ取り込み をクリックします。
  2. データの追加 ページの Databricks コネクタ で、 Zoho CRM をクリックします。
  3. インジェクションウィザードの 接続 ページで、Zoho CRM 資格情報を格納している接続を選択します。メタストアに対する CREATE CONNECTION の権限がある場合は、 プラスアイコン。 接続の作成 をクリックして、Zoho CRM への認証の構成の資格情報を使用して接続を作成します。
  4. 次へ をクリックします。
  5. インジェストの設定 ページで、パイプラインの名前を入力します。
  6. イベント Logs を書き込むカタログとスキーマを選択します。カタログに対する USE CATALOG および CREATE SCHEMA の権限がある場合は、ドロップダウンメニューの プラスアイコン。 スキーマの作成 をクリックしてスキーマを作成します。
  7. 開始日時 には、データを取り込む最も早い日時を入力します(例:2024-01-01T00:00:00+00:00)。コネクタ オプションをご覧ください。
  8. パイプラインの作成および続行 をクリックします。
  9. ソース ページで、取り込むテーブルを選択します。
  10. 保存して続行 をクリックします。
  11. 宛先 ページで、データをロードするカタログとスキーマを選択します。カタログに対する USE CATALOG および CREATE SCHEMA の権限がある場合は、ドロップダウンメニューの プラスアイコン。 スキーマの作成 をクリックしてスキーマを作成します。
  12. 保存して続行 をクリックします。
  13. (オプション) スケジュールと通知 ページで、 プラスアイコン。 スケジュールの作成 をクリックします。宛先テーブルを更新する頻度を設定します。
  14. (オプション) プラスアイコン。 通知の追加 をクリックしてパイプライン操作の成功または失敗のEメール通知を設定し、 保存してパイプラインをラン をクリックします。

例​

Zoho CRM コネクタは、default ソーススキーマでソーステーブルを利用可能にします。個々のテーブルまたはスキーマ全体を取り込みます。すべてのパイプラインでstart_datetimeを設定する必要があります。

特定のテーブルの取り込み​

このオプションを使用して、テーブルの特定のサブセットを取り込んだり、テーブルごとの宛先命名をカスタマイズしたりします。

次のパイプライン定義ファイルは、個別のZoho CRMテーブルを取り込みます。

YAML
resources:
pipelines:
zoho_crm_pipeline:
name: zoho_crm_pipeline
catalog: 'main'
target: 'zoho_crm_data'
ingestion_definition:
connection_name: zoho_crm_connection
source_configurations:
- api_source_connector_config:
configs:
start_datetime: '<start-datetime>'
objects:
- table:
source_schema: 'default'
source_table: 'leads'
destination_catalog: 'main'
destination_schema: 'zoho_crm_data'
destination_table: 'leads'
- table:
source_schema: 'default'
source_table: 'contacts'
destination_catalog: 'main'
destination_schema: 'zoho_crm_data'
destination_table: 'contacts'
- table:
source_schema: 'default'
source_table: 'deals'
destination_catalog: 'main'
destination_schema: 'zoho_crm_data'
destination_table: 'deals'

スキーマ全体を取り込む​

このオプションを使用すると、カスタムモジュールテーブルを含むすべての Zoho CRM ソーステーブルを、1 つの宣言で 1 つの変換先スキーマに取り込むことができます。

次のパイプライン定義ファイルは、サポートされているすべての Zoho CRM テーブルを宛先スキーマに取り込みます。

YAML
resources:
pipelines:
zoho_crm_pipeline:
name: zoho_crm_pipeline
catalog: 'main'
target: 'zoho_crm_data'
ingestion_definition:
connection_name: zoho_crm_connection
source_configurations:
- api_source_connector_config:
configs:
start_datetime: '<start-datetime>'
objects:
- schema:
source_schema: 'default'
destination_catalog: 'main'
destination_schema: 'zoho_crm_data'

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

以下に、宣言型自動化バンドルで使用するためのジョブ定義ファイルの例を示します。このジョブは毎日実行されます。

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

一般的なパターン​

高度なパイプライン構成については、マネージドインジェクションパイプラインの一般的なパターンを参照してください。

次のステップ​

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

その他のリソース​