Copy アクティビティで Azure Database for MySQL を構成する
この記事では、データ パイプラインでのコピー アクティビティを使用して、Azure Database for MySQL との間でデータをコピーする方法について説明します。
このコネクタは、以下に特化しています。
オンプレミスまたはクラウドにある汎用 MySQL データベースからデータをコピーするには、MySQL コネクタを使用します。
サポートされている構成
Copy アクティビティの下の各タブの構成については、それぞれ次のセクションを参照してください。
全般
[全般設定] タブを構成するには、全般設定のガイダンスを参照してください。
ソース
コピー アクティビティの [ソース] タブの Azure Database for MySQL では、次のプロパティがサポートされています。
次のプロパティは必須です。
- [接続]: 接続リストから Azure Database for MySQL の接続を選択します。 接続が存在しない場合は、[その他] を選択して新しい Azure Database for MySQL を作成します。
- [クエリの使用]: [テーブル] と [クエリ] から選択します。
[テーブル] を選択した場合:
- テーブル: データを読み取る Azure Database for MySQL データベース内のテーブルの名前を指定します。 ドロップダウンリストからテーブルを選択するか、テーブル名を入力します。
[クエリ] を選択した場合:
[クエリ]: カスタムの SQL クエリを使用してデータを読み取ります。 (例:
SELECT * FROM MyTable
)。
[詳細設定] では、次のフィールドを指定できます。
クエリ タイムアウト (分): クエリ要求がタイムアウトするまでの待機時間を指定します。デフォルトは 120 分 (02:00:00) です。
追加の列: ソース ファイルの相対パスまたは静的値を保存するための追加のデータ列を追加します。 後者では式がサポートされています。
宛先
Azure Database for MySQL では、コピー アクティビティの [コピー先] タブの次のプロパティがサポートされています。
- [接続]: 接続リストから Azure Database for MySQL の接続を選択します。 接続が存在しない場合は、[その他] を選択して新しい Azure Database for MySQL を作成します。
- テーブル: データを書き込む Azure Database for MySQL データベース内のテーブルの名前を指定します。 ドロップダウンリストからテーブルを選択するか、テーブル名を入力します。
[詳細設定] では、次のフィールドを指定できます。
- コピー前のスクリプト: コピー アクティビティの毎回の実行で、データを Azure Database for MySQL に書き込む前に実行する SQL クエリを指定します。 このプロパティを使用して、事前に読み込まれたデータをクリーンアップできます。
- [書き込みバッチ タイムアウト]: 一括挿入操作がタイムアウトになるまでの待機時間を指定します。使用できる値は Timespan であり、例は、00:30:00 (30 分) です。
- 書き込みバッチサイズ:バッファー サイズが指定された書き込みバッチ サイズに達したときに、Azure Database for MySQL テーブルにデータを挿入します。 許容値は行数を表す整数であり、デフォルト値は 10,000 です。
マッピング
[マッピング] タブの構成については、「[マッピング] タブでマッピングを構成する」をご覧ください。
設定
[設定] タブの構成については、「[設定] タブで他の設定を構成する」を参照してください。
表の概要
次の表に、Azure Database for MySQL でのコピー アクティビティの詳細を示します。
ソース情報
名前 | Description | Value | 必須 | JSON スクリプト プロパティ |
---|---|---|---|---|
接続 | ソース データ ストアへの実際の接続。 | <Azure Database for MySQL 接続> | はい | つながり |
[クエリの使用] | Azure Database for MySQL のデータの読み取り方法。 [テーブル] を適用して指定したテーブルからデータを読み取るか、SQL クエリを使用してデータを読み取るために [クエリ] を適用します。 | • [テーブル] • [クエリ] |
はい | / |
Table | Azure Database for MySQL 内のテーブルの名前。 | <テーブル名> | [クエリの使用] で [テーブル] を選択した場合は [はい] | tableName |
クエリ | カスタム SQL クエリを使用してデータを読み取ります。 (例: SELECT * FROM MyTable )。 |
<SQL クエリ> | [クエリの使用] で [クエリ] を選択した場合は [はい] | クエリ |
クエリ タイムアウト (分) | クエリ コマンド実行のタイムアウト。 | < クエリのタイムアウト > (既定値は 120 分です) |
いいえ | queryTimeout |
追加の列 | ソース ファイルの相対パスまたは静的値を保存するための追加のデータ列を追加します。 後者では式がサポートされています。 | • 名前 • 値 |
いいえ | additionalColumns: •名前 • value |
コピー先の情報
名前 | Description | Value | 必須 | JSON スクリプト プロパティ |
---|---|---|---|---|
接続 | コピー先データ ストアへの接続。 | <Azure Database for MySQL 接続> | はい | つながり |
Table | Azure Database for MySQL 内のテーブルの名前。 | <テーブル名> | はい | tableName |
コピー前スクリプト | コピー アクティビティの毎回の実行で、データを Azure Database for MySQL に書き込む前に実行する SQL クエリ。 このプロパティを使用して、事前に読み込まれたデータをクリーンアップできます。 | <ユーザーの事前コピー スクリプト> | いいえ | preCopyScript |
[書き込みバッチ タイムアウト] | タイムアウトする前に一括挿入操作の完了を待つ時間です。 | timespan (デフォルトは 00:00:30) | いいえ | writeBatchTimeout |
[Write batch size](書き込みバッチ サイズ) | バッファー サイズが指定された書き込みバッチ サイズに達したときに、Azure Database for MySQL テーブルにデータを挿入します。 | integer (既定値は 10,000) |
いいえ | writeBatchSize |