Dataphin:TDSQL for MySQL データソースの作成

権限要件

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

操作手順

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

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

3. [データソースの作成] ページで、[リレーショナルデータベース] セクションに移動し、[TDSQL For MySQL] を選択します。

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

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

   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、および GaussDB データウェアハウスサービス (DWS) のデータソースのみがサポートされています。
      データソースの説明	TDSQL for MySQL データソースの簡単な説明です。説明は 128 文字以内で入力してください。
      データソース構成	本番データソースと開発データソースを区別するかどうかを選択します： ビジネスデータソースが本番データソースと開発データソースを区別する場合は、[本番 + 開発データソース] を選択します。 ビジネスデータソースがそれらを区別しない場合は、[本番データソース] を選択します。
      タグ	タグを使用してデータソースを分類できます。タグの作成方法の詳細については、「データソースタグの管理」をご参照ください。

   2. データソースと Dataphin 間の接続パラメーターを構成します。

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

      説明

      通常、環境の隔離を確保するために、本番データソースと開発データソースは異なるものであるべきです。これにより、開発データソースが本番データソースに影響を与えるのを防ぎます。ただし、Dataphin は、同一のパラメーター値で構成すれば、両方の環境に同じデータソースを使用することもサポートしています。

      [構成方法] で、[JDBC URL] または [ホスト] を選択します。デフォルトは JDBC URL です。

      JDBC URL 構成

      パラメーター	説明
      JDBC URL	JDBC URL のフォーマットは jdbc:mysql://host:port/dbname です。 説明 TDSQL for MySQL データソースのデフォルトポートは 3306 です。
      ユーザー名、パスワード	データベースのユーザー名とパスワード。

      ホスト構成

      • ホスト構成

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

      • パラメーター構成

        パラメーター	説明
        パラメーター	パラメーター名：既存のパラメーター名を選択するか、カスタム名を入力します。 カスタムパラメーター名には、英字、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) のみ使用できます。 パラメーター値：パラメーター名を選択した場合に必須です。値には、英字、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) のみ使用できます。値の長さは最大 256 文字です。 説明 [+パラメーターの追加] をクリックして、複数のパラメーターを追加します。 アイコンをクリックして、余分なパラメーターを削除します。最大 30 個のパラメーターを追加できます。
        ユーザー名、パスワード	TDSQL for MySQL インスタンスにログインするためのユーザー名とパスワード。

      説明

      構成方法としてホストを選択してから JDBC URL メソッドに切り替えると、システムはサーバーの IP アドレスとポート番号を組み合わせて JDBC URL を自動入力します。

   3. データソースの詳細設定を構成します。

      パラメーター	説明
      connectTimeout	データベースの接続タイムアウト期間 (ミリ秒)。デフォルトは 900,000 ms (15 分) です。 説明 JDBC URL で `connectTimeout` を指定した場合、その値が使用されます。 Dataphin V3.11 より前に作成されたデータソースの場合、デフォルトの `connectTimeout` は -1 であり、タイムアウト制限がないことを意味します。
      socketTimeout	データベースのソケットタイムアウト期間 (ミリ秒)。デフォルトは 1,800,000 ms (30 分) です。 説明 JDBC URL で `socketTimeout` を指定した場合、その値が使用されます。 Dataphin V3.11 より前に作成されたデータソースの場合、デフォルトの `socketTimeout` は -1 であり、タイムアウト制限がないことを意味します。
      接続リトライ	データベース接続がタイムアウトした場合、システムは指定された回数まで自動的に接続をリトライします。最大リトライ回数を超えても接続が失敗した場合、接続試行は失敗します。 説明 デフォルトは 1 回のリトライです。0～10 の範囲で値を設定できます。 接続リトライ回数は、デフォルトでオフライン統合タスクとグローバル品質チェックに適用されます。グローバル品質チェックには、アセット品質モジュールを有効にする必要があります。オフライン統合タスクでは、タスクレベルのリトライ回数を個別に構成できます。

   説明

   重複するパラメーターには、次の優先順位ルールが適用されます：

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

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

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

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

6. [接続テスト] をクリックするか、[OK] をクリックして構成を保存し、TDSQL for MySQL データソースを作成します。

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

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

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

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

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

     説明

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

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

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