次の方法で共有


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