Copy アクティビティで Azure Data Explorer を構成する
この記事では、データ パイプラインでのコピー アクティビティを使用して、Azure Data Explorer との間でデータをコピーする方法について説明します。
サポートされている構成
Copy アクティビティの下の各タブの構成については、それぞれ次のセクションを参照してください。
全般
[全般] タブの構成で、[全般] に移動します。
ソース
コピー アクティビティの [ソース] タブの Azure Data Explorer では、次のプロパティがサポートされています。
次のプロパティは必須です。
[データ ストアの種類]: [外部] を選択します。
接続: 接続リストから Azure Data Explorer の接続を選択します。 接続が存在しない場合は、[新規] を選択して新しい Azure Data Explorer 接続を作成します。
[データベース]: ドロップ ダウン リストからデータベースを選びます。
クエリの使用: [テーブル] または [クエリ] を選びます。
テーブル: データを読み取るには、ドロップダウン リストからテーブルを選択するか、[編集] を選択して手動で入力します。
[クエリ]: 読み取り専用の要求を KQL 形式で指定します。 参照としてカスタム KQL クエリを使用します。
[詳細設定] では、次のフィールドを指定できます。
- [クエリのタイムアウト]: クエリ要求がタイムアウトするまでの待機時間を指定します。既定値は 10 分 (00:10:00) です。 使用できる最大値は 1 時間 (01:00:00) です。
- [切り捨てなし]: 返される結果セットを切り捨てるかどうかを示します。 既定では、結果は 500,000 件のレコードまたは 64 MB を超えると切り捨てられます。 アクティビティの適切な動作のためには、切り詰めを強くお勧めします。
- [追加の列]: ソース ファイルの相対パスまたは静的値を格納するための追加のデータ列を追加します。 後者では式がサポートされています。
宛先
コピー アクティビティの [場所] タブの Azure Data Explorer では、次のプロパティがサポートされています。
次のプロパティは必須です。
- [データ ストアの種類]: [外部] を選択します。
- 接続: 接続リストから Azure Data Explorer の接続を選択します。 接続が存在しない場合は、[新規] を選択して新しい Azure Data Explorer 接続を作成します。
- [データベース]: ドロップ ダウン リストからデータベースを選びます。
- テーブル: データを書き込むには、ドロップダウン リストからテーブルを選択するか、[編集] を選択して手動で入力します。
[詳細設定] では、次のフィールドを指定できます。
Ingestion mapping name (インジェスト マッピング名): 事前に作成され、Azure Data Explorer のコピー先テーブルに事前に割り当てられたマッピングの名前を指定します。
その他のプロパティ:Azure Data Explorer のコピー先によってまだ設定されていないインジェスト プロパティを指定するために使用できるプロパティ バッグ。 具体的には、インジェスト タグの指定に便利です。 詳細については「Azure Data Explore データ インジェスト」を参照してください。
マッピング
[マッピング] タブの構成については、「[マッピング] タブでマッピングを構成する」を参照してください。
設定
[設定] タブの構成については、「[設定] タブで他の設定を構成する」を参照してください。
表の概要
次の表に、Azure Data Explorer でのコピー アクティビティの詳細を示します。
ソース情報
| 名前 | Description | Value | 必須 | JSON スクリプト プロパティ |
|---|---|---|---|---|
| データ ストアの種類 | データ ストアの種類。 | 外部品目番号 | はい | / |
| 接続 | ソース データ ストアへの実際の接続。 | < Azure Data Explorer 接続 > | はい | つながり |
| データベース | ソースとして使用するデータベース。 | < データベース > | はい | database |
| [クエリの使用] | データを読み取る方法。 特定のテーブルからデータを読み込むには [テーブル] を、クエリを使用してデータを読み込むには [クエリ] を選択します。 | • [テーブル] • [クエリ] |
いいえ | table query |
| クエリのタイムアウト | クエリ要求がタイムアウトになるまでの待機時間を指定します。使用できる最大値は 1 時間 (01:00:00) です。 | TimeSpan (既定値は 00:10:00 - 10 分) |
いいえ | queryTimeout |
| 切り捨てなし | 返される結果セットを切り詰めるかどうかを示します。 既定では、結果は 500,000 件のレコードまたは 64 MB を超えると切り捨てられます。 アクティビティの適切な動作のためには、切り詰めを強くお勧めします。 | オンまたはオフ | いいえ | noTruncation: true または false |
| 追加の列 | ソース ファイルの相対パスまたは静的な値を格納するための追加のデータ列を追加します。 後者では式がサポートされています。 | • 名前 • 値 |
いいえ | additionalColumns: • name • value |
コピー先の情報
| 名前 | Description | Value | 必須 | JSON スクリプト プロパティ |
|---|---|---|---|---|
| データ ストアの種類 | データ ストアの種類。 | 外部品目番号 | はい | / |
| 接続 | コピー先データ ストアへの接続。 | < Azure Data Explorer 接続 > | はい | つながり |
| データベース | コピー先として使用するデータベース。 | < データベース > | はい | database |
| テーブル | データを書き込む対象のデータ テーブル。 | <実際のテーブル名> | はい | table |
| インジェスト マッピング名 | 事前に作成され、Azure Data Explorer コピー先テーブルに事前に割り当てられたマッピングの名前。 | <実際のインジェスト マッピング名> | いいえ | ingestionMappingName |
| 追加のプロパティ | Azure Data Explorer のコピー先によってまだ設定されていないインジェスト プロパティを指定するために使用できるプロパティ バッグ。 具体的には、インジェスト タグの指定に便利です。 詳細については「Azure Data Explore データ インジェスト」を参照してください。 | • 名前 • 型 • 値 |
いいえ | additionalProperties |