すべてのプロダクト
Search

このプロダクト

    Dataphin:Microsoft SQL Server 出力コンポーネントの構成

    ドキュメントセンター

    Dataphin:Microsoft SQL Server 出力コンポーネントの構成

    最終更新日:Jul 08, 2025

    Microsoft SQL Server 出力コンポーネントは、Microsoft SQL Server データソースにデータを書き込みます。他のデータソースからのデータを Microsoft SQL Server データソースに同期するシナリオでは、ソースデータソース情報を構成した後、Microsoft SQL Server 出力コンポーネントのターゲットデータソースを構成する必要があります。このトピックでは、Microsoft SQL Server 出力コンポーネントを構成する方法について説明します。

    前提条件

    • Microsoft SQL Server データソースが作成されていること。詳細については、「Microsoft SQL Server データソースを作成する」をご参照ください。

    • Microsoft SQL Server 出力コンポーネントのプロパティを構成するために使用するアカウントは、データソースに対するライトスルー権限を持っている必要があります。権限がない場合は、データソース権限をリクエストする必要があります。詳細については、「データソース権限のリクエスト、更新、および返却」をご参照ください。

    手順

    1. Dataphin ホームページの上部ナビゲーションバーで、[開発] > [Data Integration] を選択します。

    2. 統合ページの上部のナビゲーションバーで、[プロジェクト] を選択します。(Dev-Prod モードでは、環境を選択する必要があります)

    3. 左側のナビゲーションウィンドウで、[バッチパイプライン]オフライン パイプライン をクリックし、[バッチパイプライン] リストで開発するオフラインパイプラインをクリックして、オフラインパイプラインの構成ページを開きます。

    4. ページの右上隅にある [コンポーネントライブラリ] をクリックして、[コンポーネントライブラリ] パネルを開きます。

    5. [コンポーネントライブラリ] パネルの左側のナビゲーションウィンドウで、[出力] を選択し、右側の出力コンポーネントリストで [Microsoft SQL Server] コンポーネントを見つけて、キャンバスにドラッグします。

    6. ターゲット入力コンポーネントの image アイコンをクリックしてドラッグし、現在の Microsoft SQL Server 出力コンポーネントに接続します。

    7. Microsoft SQL Server 出力コンポーネントカードの image アイコンをクリックして、[Microsoft SQL Server 出力構成] ダイアログボックスを開きます。image

    8. [Microsoft SQL Server 出力構成] ダイアログボックスで、パラメーターを構成します。

      パラメーター

      説明

      基本設定

      ステップ名

      Microsoft SQL Server 出力コンポーネントの名前。Dataphin は自動的にステップ名を生成しますが、ビジネスシナリオに基づいて変更できます。名前は次の要件を満たしている必要があります。

      • 漢字、英字、アンダースコア (_)、数字のみ使用できます。

      • 最大 64 文字まで使用できます。

      データソース

      データソースドロップダウンリストには、ライトスルー権限を持つデータソースと持たないデータソースを含む、すべての Microsoft SQL Server データソースが表示されます。image アイコンをクリックして、現在のデータソース名をコピーします。

      タイムゾーン

      時間形式のデータは、現在のタイムゾーンに従って処理されます。デフォルトは、選択したデータソースで構成されたタイムゾーンで、変更できません。

      説明

      V5.1.2 より前に作成されたタスクの場合、[データソースのデフォルト構成] または [チャネル構成のタイムゾーン] を選択できます。デフォルトの選択は [チャネル構成のタイムゾーン] です。

      • [データソースのデフォルト構成]：選択したデータソースのデフォルトのタイムゾーン。

      • [チャネル構成のタイムゾーン]：現在の統合タスクの [プロパティ] > [チャネル構成] で構成されたタイムゾーン。

      スキーマ (オプション)

      クロススキーマテーブルの選択をサポートします。テーブルが配置されているスキーマを選択します。指定しない場合、デフォルトはデータソースで構成されたスキーマです。

      テーブル

      出力データのターゲットテーブルを選択します。 キーワードを入力してテーブルを検索するか、正確なテーブル名を入力して [完全一致] をクリックします。テーブルを選択すると、システムは自動的にテーブルステータスチェックを実行します。image アイコンをクリックして、現在選択されているテーブルの名前をコピーします。

      ロードポリシー

      ターゲットテーブルにデータを書き込むためのポリシーを選択します。[ロードポリシー] には以下が含まれます。

      • [データの追加（insert Into）]：プライマリキー/制約の競合がある場合、ダーティデータエラーが表示されます。

      • [プライマリキーの競合時に更新（merge Into）]：プライマリキー/制約の競合がある場合、マッピングされたフィールドのデータが既存のレコードで更新されます。

      同期書き込み

      プライマリキー更新構文はアトミック操作ではありません。書き込むデータに重複するプライマリキーがある場合は、同期書き込みを有効にする必要があります。そうでない場合は、並列書き込みが使用されます。同期書き込みのパフォーマンスは、並列書き込みよりも低くなります。

      説明

      このオプションは、ロードポリシーが [プライマリキーの競合時に更新] に設定されている場合にのみ使用できます。

      バッチ書き込みデータサイズ

      一度に書き込むデータのサイズ。[バッチ書き込みレコード] を設定することもできます。書き込み時、システムは最初に達した制限に従って書き込みます。デフォルトは 32M です。

      バッチ書き込みレコード

      デフォルトは 2048 レコードです。データを同期する場合、バッチ書き込み戦略が使用され、パラメーターには [バッチ書き込みレコード] と [バッチ書き込みデータサイズ] が含まれます。

      • 累積データが設定された制限（つまり、バッチ書き込みデータサイズまたはレコード数制限）のいずれかに達すると、システムはデータのバッチが満杯であると見なし、このデータのバッチをすぐにターゲットに一度に書き込みます。

      • バッチ書き込みデータサイズを 32MB に設定することをお勧めします。バッチ挿入レコード制限については、単一レコードの実際のサイズに応じて柔軟に調整でき、通常はバッチ書き込みの利点を最大限に活用するために大きな値に設定します。たとえば、単一レコードのサイズが約 1KB の場合、バッチ挿入バイトサイズを 16MB に設定し、この条件を考慮して、バッチ挿入レコード数を 16MB を単一レコードサイズ 1KB で割った結果よりも大きい値（つまり、16384 レコードよりも大きい値）に設定します。ここでは 20000 レコード に設定されていると仮定します。この構成では、システムはバッチ挿入バイトサイズに基づいてバッチ書き込み操作をトリガーし、累積データが 16MB に達するたびに書き込み操作を実行します。

      準備ステートメント

      オプション。データインポートの前にデータベースで実行される SQL スクリプト。

      たとえば、継続的なサービスの可用性を確保するために、現在のステップがデータを書き込む前に、まずターゲットテーブル Target_A を作成し、Target_A への書き込みを実行し、現在のステップがデータの書き込みを完了した後、継続的にサービスを提供するテーブル Service_B の名前を Temp_C に変更し、次にテーブル Target_A の名前を Service_B に変更し、最後に Temp_C を削除します。

      終了ステートメント

      オプション。データインポート後にデータベースで実行される SQL スクリプト。

      フィールドマッピング

      入力フィールド

      上流コンポーネントの出力に基づいて入力フィールドを表示します。

      出力フィールド

      出力フィールドを表示します。次の操作を実行できます。

      • フィールド管理：[フィールド管理] をクリックして出力フィールドを選択します。

        image

        • gaagag アイコンをクリックして、[選択済みの入力フィールド] を [選択されていない入力フィールド] に移動します。

        • agfag アイコンをクリックして、[選択されていない入力フィールド] を [選択済みの入力フィールド] に移動します。

      • 一括追加：[一括追加] をクリックして、JSON、TEXT、および DDL 形式での一括構成をサポートします。

        • JSON 形式のバッチ構成。例：

          // 例：
[{"name":"id","type":"String"},
{"name":"aaasa","type":"String"},
{"name":"creator","type":"String"},
{"name":"modifier","type":"String"},
{"name":"creator_nickname","type":"String"},
{"name":"modifier_nickname","type":"String"},
{"name":"create_time","type":"Date"},
{"name":"modify_time","type":"Date"},
{"name":"qbi_system_upload_id","type":"Long"}]
          説明

          name はインポートされたフィールド名を表し、type はインポート後のフィールドタイプを表します。たとえば、"name":"user_id","type":"String" は、user_id という名前のフィールドをインポートし、そのフィールドタイプを String に設定することを意味します。

        • TEXT 形式のバッチ構成。例：

          // 例：
id,String
aaasa,String
creator,String
modifier,String
creator_nickname,String
modifier_nickname,String
create_time,Date
modify_time,Date
qbi_system_upload_id,Long

          • 行区切り文字は、各フィールドの情報を区切るために使用されます。デフォルトは改行（\n）で、改行（\n）、セミコロン（;）、ピリオド（.）をサポートしています。

          • 列区切り文字は、フィールド名とフィールドタイプを区切るために使用されます。デフォルトはカンマ（,）です。

        • DDL 形式のバッチ構成。例：

          CREATE TABLE tablename (
    id INT PRIMARY KEY,
    name VARCHAR(50),
    age INT
);

      • 新しい出力フィールドの作成：[+ 新しい出力フィールドの作成] をクリックし、プロンプトに従って [列] に入力し、[タイプ] を選択します。現在の行の構成が完了したら、image アイコンをクリックして保存します。

      クイックマッピング

      上流の入力とターゲットテーブルのフィールドに基づいて、フィールドマッピングを手動で選択できます。[クイックマッピング] には、[同じ行のマッピング] と [同じ名前のマッピング] が含まれます。

      • 同じ名前のマッピング：同じ名前のフィールドをマッピングします。

      • 同じ行のマッピング：ソーステーブルとターゲットテーブルのフィールド名は一致しませんが、フィールドの対応する行のデータをマッピングする必要があります。同じ行のフィールドのみをマッピングします。

    9. [OK] をクリックして、[Microsoft SQL Server] 出力コンポーネントのプロパティ構成を完了します。