Dataphin:Microsoft SQL Server データソースの作成

権限要件

次のロールがデータソースを作成できます: スーパー管理者、データソース管理者、ドメインアーキテクト、プロジェクト管理者、および データソース作成権限 を持つカスタムグローバルロール。

手順

1. Dataphin のホームページで、上部のメニューバーから [管理ハブ] > [データソース管理] を選択します。

2. [データソース] ページで、[+データソースの作成] をクリックします。

3. [データソースの作成] ページで、[リレーショナルデータベース] セクションから Microsoft SQL Server を選択します。

   最近 Microsoft SQL Server を使用した場合は、[最近使用した] セクションから選択することもできます。または、検索ボックスに Microsoft SQL Server と入力してすばやく見つけることもできます。

4. [Microsoft SQL Server データソースの作成] ページで、データソースの接続パラメーターを構成します。

   1. 基本情報を構成します。

      パラメーター	説明
      データソース名	データソースの名前を入力します。名前は次のルールに従う必要があります: 漢字、文字、数字、アンダースコア (_)、ハイフン (-) のみを含めることができます。 長さは 64 文字以内である必要があります。
      データソースコード	データソースコードを構成すると、Flink SQL ノードで、または Dataphin Java Database Connectivity (JDBC) クライアントを使用して、Dataphin データソーステーブルに直接アクセスできます。迅速なデータアクセスのために、datasource_code.table_name または datasource_code.schema.table_name のフォーマットを使用します。ノードの実行環境に基づいてデータソースを自動的に切り替えるには、変数フォーマット ${datasource_code}.table または ${datasource_code}.schema.table を使用します。詳細については、「Dataphin データソーステーブルを開発する」をご参照ください。 重要 データソースコードは、構成後に変更することはできません。 データソースコードが構成された後でのみ、アセットディレクトリおよびアセットインベントリのオブジェクト詳細ページでデータをプレビューできます。 Flink SQL では、MySQL、Hologres、MaxCompute、Oracle、StarRocks、Hive、および SelectDB データソースのみがサポートされています。
      データソースの説明	データソースの簡単な説明。説明は 128 文字を超えることはできません。
      タイムゾーン	統合ノードの時間形式のデータは、選択したタイムゾーンに基づいて処理されます。デフォルトのタイムゾーンは Asia/Shanghai です。[変更] をクリックしてタイムゾーンを選択します。オプションは次のとおりです: GMT: GMT-12:00、GMT-11:00、GMT-10:00、GMT-09:30、GMT-09:00、GMT-08:00、GMT-07:00、GMT-06:00、GMT-05:00、GMT-04:00、GMT-03:00、GMT-03:00、GMT-02:30、GMT-02:00、GMT-01:00、GMT+00:00、GMT+01:00、GMT+02:00、GMT+03:00、GMT+03:30、GMT+04:00、GMT+04:30、GMT+05:00、GMT+05:30、GMT+05:45、GMT+06:00、GMT+06:30、GMT+07:00、GMT+08:00、GMT+08:45、GMT+09:00、GMT+09:30、GMT+10:00、GMT+10:30、GMT+11:00、GMT+12:00、GMT+12:45、GMT+13:00、GMT+14:00。 夏時間: Africa/Cairo、America/Chicago、America/Denver、America/Los_Angeles、America/New_York、America/Sao_Paulo、Asia/Bangkok、Asia/Dubai、Asia/Kolkata、Asia/Shanghai、Asia/Tokyo、Atlantic/Azores、Australia/Sydney、Europe/Berlin、Europe/London、Europe/Moscow、Europe/Paris、Pacific/Auckland、Pacific/Honolulu。
      データソース構成	構成するデータソースを選択します: ビジネスデータソースが本番データソースと開発データソースを区別する場合は、[本番 + 開発データソース] を選択します。 ビジネスデータソースが本番データソースと開発データソースを区別しない場合は、[本番データソース] を選択します。
      タグ	データソースを分類し、ラベルを付けることができます。タグの作成方法の詳細については、「データソースタグの管理」をご参照ください。

   2. 接続パラメーターを構成します。

      [データソース構成] を [本番 + 開発データソース] に設定した場合は、両方の環境の接続情報を構成する必要があります。[本番データソース] に設定した場合は、本番データソースの接続情報のみを構成する必要があります。

      説明

      通常、本番データソースと開発データソースは、2 つの環境を分離するために異なります。この方法は、開発環境が本番環境に与える影響を軽減します。ただし、同じパラメーター値を使用して、同じデータソースとして構成することもできます。

      [構成メソッド] で、[JDBC URL] または [ホスト] を選択します。JDBC URL がデフォルトのメソッドです。

      JDBC URL 構成

      パラメーター	説明
      JDBC URL	エンドポイントのフォーマットは jdbc:sqlserver://host:port/dbname です。
      スキーマ	ユーザー名に関連付けられているスキーマを入力します。
      ユーザー名、パスワード	ターゲットデータベースのユーザー名とパスワードを入力します。

      ホスト構成

      • ホスト構成

        パラメーター	説明
        サーバーアドレス	サーバーの IP アドレスとポート番号を入力します。 [+追加] をクリックして、複数の IP アドレスとポート番号を追加します。 アイコンをクリックして、余分な IP アドレスとポート番号を削除します。少なくとも 1 つの IP アドレスとポート番号を保持する必要があります。
        dbname	データベース名を入力します。

      • パラメーター構成

        パラメーター	説明
        パラメーター	パラメーター名: 既存のパラメーター名を選択するか、カスタムパラメーター名を入力します。 カスタムパラメーター名には、文字、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) のみを含めることができます。 パラメーター値: パラメーター名を選択した場合、このパラメーターは必須です。値には、文字、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) のみを含めることができます。値の長さは最大 256 文字です。 説明 [+パラメーターの追加] をクリックして、複数のパラメーターを追加します。 アイコンをクリックして、余分なパラメーターを削除します。最大 30 個のパラメーターを追加できます。
        スキーマ	ユーザー名に関連付けられているスキーマ情報を入力します。
        ユーザー名、パスワード	Microsoft SQL Server インスタンスへのログインに使用するユーザー名とパスワード。

      説明

      • instanceName パラメーターを設定した場合、それが優先され、構成された port は無視されます。

      • 構成メソッドとして [ホスト] を選択してから JDBC URL メソッドに切り替えると、システムはサーバーの IP アドレスとポート番号を自動的に連結して JDBC URL を作成します。

   3. 詳細設定を構成します。

      パラメーター	説明
      loginTimeout	データベースのログインタイムアウト期間 (秒単位)。デフォルト値: 900 (15 分)。 説明 JDBC URL に loginTimeout 構成が含まれている場合、JDBC URL のタイムアウト値が使用されます。 Dataphin V3.11 より前に作成されたデータソースの場合、loginTimeout のデフォルト値は -1 で、タイムアウト制限がないことを示します。
      socketTimeout	データベースのソケットタイムアウト期間 (ミリ秒単位)。デフォルト値: 1800000 (30 分)。 説明 JDBC URL に socketTimeout 構成が含まれている場合、JDBC URL のタイムアウト値が使用されます。 Dataphin V3.11 より前に作成されたデータソースの場合、socketTimeout のデフォルト値は -1 で、タイムアウト制限がないことを示します。
      接続リトライ	データベース接続がタイムアウトした場合、システムは指定された回数だけ自動的に接続をリトライします。最大リトライ回数を超えても接続が失敗した場合、接続は失敗します。 説明 デフォルトのリトライ回数は 1 です。このパラメーターは 0 から 10 の値に設定できます。 接続リトライ回数は、デフォルトで オフライン統合ノード と グローバル品質 に適用されます。グローバル品質機能を使用するには、アセット品質モジュールを有効にする必要があります。オフライン統合ノードの場合、ノードレベルでリトライ回数を構成できます。

   説明

   重複するパラメーターの値の優先順位:

   • パラメーターが [JDBC URL]、[詳細設定]、および [ホスト構成] で構成されている場合、[JDBC URL] の値が優先されます。

   • パラメーターが [JDBC URL] と [詳細設定] の両方で構成されている場合、[JDBC URL] の値が優先されます。

   • パラメーターが [詳細設定] と [ホスト構成] の両方で構成されている場合、[詳細設定] の値が優先されます。

5. [デフォルトリソースグループ] を選択します。このリソースグループは、データベース SQL ノード、オフライン完全データベース移行タスク、データプレビューなど、このデータソースに関連するノードを実行するために使用されます。

6. [接続テスト] をクリックして接続を検証するか、[OK] をクリックして構成を保存し、Microsoft SQL Server データソースを作成します。

   [接続テスト] をクリックして、Dataphin がデータソースに接続できるかどうかをテストします。[OK] を直接クリックすると、システムは選択したすべてのクラスターの接続を自動的にテストします。接続テストが失敗した場合でも、データソースを作成できます。

   [接続テスト] は、Dataphin に登録され、通常使用されている デフォルトクラスター または 登録済みスケジューリングクラスター の接続をテストします。デフォルトクラスター はデフォルトで選択されており、選択を解除することはできません。登録済みスケジューリングクラスター の下にリソースグループがない場合、接続テストはサポートされません。接続をテストする前に、まずリソースグループを作成する必要があります。

   • 選択したクラスターは、現在のデータソースとのネットワーク接続をテストするためにのみ使用され、後で関連タスクを実行するためには使用されません。

   • 接続テストは通常 2 分未満で完了します。タイムアウトした場合は、 アイコンをクリックして具体的な理由を確認し、リトライできます。

   • テスト結果が [接続に失敗しました]、[接続に成功しました]、または [警告付きで成功] のいずれであっても、システムは最終結果の生成時刻を記録します。

     説明

     デフォルトクラスター のテスト結果には、[警告付きで成功]、[接続に成功しました]、[接続に失敗しました] の 3 つの接続ステータスが含まれます。Dataphin の 登録済みスケジューリングクラスター のテスト結果には、[接続に成功しました] と [接続に失敗しました] の 2 つの接続ステータスのみが含まれます。

   • テスト結果が [接続に失敗しました] の場合、 アイコンをクリックして具体的な失敗理由を表示できます。

   • テスト結果が [警告付きで成功] の場合、アプリケーションクラスターの接続は成功しましたが、スケジューリングクラスターの接続に失敗したことを意味します。現在のデータソースは、データ開発および統合には使用できません。 アイコンをクリックしてログ情報を表示できます。