Data Factory または Synapse Analytics を使用して、Zendesk (プレビュー) でデータを変換する
適用対象: Azure Data Factory
Azure Synapse Analytics
ヒント
企業向けのオールインワン分析ソリューション、Microsoft Fabric の Data Factory をお試しください。 Microsoft Fabric は、データ移動からデータ サイエンス、リアルタイム分析、ビジネス インテリジェンス、レポートまで、あらゆるものをカバーしています。 無料で新たに試用を開始する方法については、こちらをご覧ください。
この記事では、Data Flow を使用して Zendesk (プレビュー) でデータを変換する方法について説明します。 詳細については、Azure Data Factory または Azure Synapse Analytics の概要記事を参照してください。
重要
このコネクタは、現在プレビューの段階です。 実際にお試しいただき、フィードバックをお寄せください。 ソリューションでプレビュー版コネクタの依存関係を取得したい場合、Azure サポートにお問い合わせください。
サポートされる機能
この Zendesk コネクタでは、次の機能がサポートされます。
サポートされる機能 | IR |
---|---|
マッピング データ フロー (ソース/-) | 1 |
① Azure 統合ランタイム ② セルフホステッド統合ランタイム
ソースおよびシンクとしてサポートされているデータ ストアの一覧については、「サポートされているデータ ストア」の表を参照してください。
UI を使用して Zendesk のリンクされたサービスを作成する
次の手順を使用して、Azure portal UI で Zendesk のリンク サービスを作成します。
Azure Data Factory または Synapse ワークスペースの [管理] タブに移動し、[リンク サービス] を選択して、[新規] を選択します。
Zendesk UI.(プレビュー) を検索し、Zendesk (プレビュー) コネクタを選択します。
サービスの詳細を構成し、接続をテストして、新しいリンク サービスを作成します。
コネクタの構成の詳細
以下のセクションでは、Zendesk に固有の Data Factory および Synapse パイプライン エンティティの定義に使用されるプロパティについて説明します。
リンクされたサービスのプロパティ
Zendesk のリンクされたサービスでは、以下のプロパティがサポートされます。
プロパティ | Description | 必須 |
---|---|---|
type | type プロパティは Zendesk に設定する必要があります。 | はい |
url | Zendesk サービスのベース URL。 | はい |
authenticationType | Zendesk サービスへの接続に使用される認証の種類。 使用可能な値は basic および token です。 それぞれのプロパティとサンプルについては、以下の対応するセクションを参照してください。 | はい |
[基本認証]
authenticationType プロパティを basic に設定します。 前のセクションで説明した汎用的なプロパティに加えて、次のプロパティを指定します。
プロパティ | Description | 必要 |
---|---|---|
userName | Zendesk にログインするために使用するユーザー名。 | はい |
password | ユーザー名に指定したユーザー アカウントのパスワードを指定します。 安全に保存するには、このフィールドを SecureString としてマークします。 また、Azure Key Vault に格納されているシークレットを参照することもできます。 | はい |
例:
{
"name": "ZendeskLinkedService",
"properties": {
"type": "Zendesk",
"typeProperties": {
"url": "<base url>",
"authenticationType": "basic",
"userName": "<user name>",
"password": {
"type": "SecureString",
"value": "<password>"
}
}
}
}
認証トークン
authenticationType プロパティを token に設定します。 前のセクションで説明した汎用的なプロパティに加えて、次のプロパティを指定します。
プロパティ | Description | 必須 |
---|---|---|
apiToken | Zendesk の API トークンを指定します。 安全に保存するには、このフィールドを SecureString としてマークします。 また、Azure Key Vault に格納されているシークレットを参照することもできます。 | はい |
例:
{
"name": "ZendeskLinkedService",
"properties": {
"type": "Zendesk",
"typeProperties": {
"url": "<base url>",
"authenticationType": "token",
"apiToken": {
"type": "SecureString",
"value": "<API token>"
}
}
}
}
Mapping Data Flow のプロパティ
マッピング データ フローでデータを変換する場合、Zendesk からテーブルの読み取りができます。 詳細については、マッピング データ フローのソース変換に関するページを参照してください。 インライン データセットは、ソースの種類としてのみ使用できます。
ソース変換
次の表に、Zendesk ソースでサポートされるプロパティの一覧を示します。 これらのプロパティは、 [ソース オプション] タブで編集できます。
名前 | 説明 | 必須 | 使用できる値 | データ フロー スクリプトのプロパティ |
---|---|---|---|---|
Entity | Zendesk 内のエンティティの論理名。 | インラインモードを使用する場合は、はい | activities group_memberships groups organizations requests satisfaction_ratings sessions tags targets ticket_audits ticket_fields ticket_metrics tickets triggers users views |
エンティティ |
Zendesk のソース スクリプトの例
source(allowSchemaDrift: true,
validateSchema: false,
store: 'zendesk',
format: 'rest',
entity: 'tickets') ~> ZendeskSource
関連するコンテンツ
コピー アクティビティによってソース、シンクとしてサポートされるデータ ストアの一覧については、サポートされるデータ ストアに関するセクションを参照してください。