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