Dataphin がビジネスデータを読み取ったり、PolarDB-X 2.0 にデータを書き込んだりできるように、PolarDB-X 2.0 データソースを作成します。
権限
[データソースの作成] 権限を含むカスタムグローバルロールを持つユーザー、またはスーパー管理者、データソース管理者、ボードアーキテクト、プロジェクト管理者のシステムロールを持つユーザーのみがデータソースを作成できます。
手順
Dataphin のホームページの上部のメニューバーで、[管理センター] > [データソース管理] を選択します。
[データソース] ページで、[+ 新規データソース] をクリックします。
[新規データソース] ページの [リレーショナルデータベース] エリアで、[PolarDB-X 2.0] を選択します。
最近 PolarDB-X 2.0 を使用した場合は、[最近使用したもの] エリアから選択することもできます。または、検索ボックスに `PolarDB-X 2.0` と入力してすばやく見つけることもできます。
[PolarDB-X 2.0 データソースの作成] ページで、データソース接続パラメーターを構成します。
データソースの基本情報を構成します。
パラメーター
説明
データソース名
データソースの名前を入力します。命名規則は次のとおりです。
名前に使用できるのは、漢字、大文字と小文字、数字、アンダースコア (_)、ハイフン (-) のみです。
名前の長さは最大 64 文字です。
データソースコード
データソースコードを設定すると、Flink_SQL タスクで、または Dataphin Java Database Connectivity (JDBC) クライアントを使用して、Dataphin データソーステーブルに直接アクセスできます。フォーマット
data_source_code.table_nameまたはdata_source_code.schema.table_nameを使用します。タスク実行環境に基づいてデータソースを自動的に切り替えるには、変数フォーマット${data_source_code}.tableまたは${data_source_code}.schema.tableを使用します。詳細については、「Dataphin データソーステーブルを使用した開発」をご参照ください。重要データソースコードは、設定後に変更することはできません。
データソースコードが設定された後にのみ、アセットディレクトリおよびアセットインベントリのオブジェクト詳細ページでデータをプレビューできます。
Flink SQL では、MySQL、Hologres、MaxCompute、Oracle、StarRocks、Hive、および SelectDB データソースのみがサポートされています。
データソースの説明
データソースの簡単な説明。説明は 128 文字を超えることはできません。
データソース構成
構成するデータソースを選択します。
ビジネスデータソースが本番データソースと開発データソースに分かれている場合は、[本番+開発データソース] を選択します。
ビジネスデータソースが分離されていない場合は、[本番データソース] を選択します。
タグ
分類のためにデータソースにタグを追加できます。タグの作成方法の詳細については、「データソースタグの管理」をご参照ください。
データソースが Dataphin に接続するための接続パラメーターを構成します。
[データソース構成] を [本番+開発データソース] に設定した場合は、本番データソースと開発データソースの両方の接続情報を構成します。[本番データソース] に設定した場合は、本番データソースの接続情報のみを構成します。
説明通常、本番データソースと開発データソースは、環境を分離し、開発環境が本番環境に与える影響を軽減するために、異なるものである必要があります。ただし、Dataphin では、同じパラメーター値を使用して同じデータソースとして構成できます。
パラメーター
説明
JDBC URL
エンドポイントのフォーマットは
jdbc:mysql://host:port/dbnameです。ユーザー名、パスワード
データベースにログインするためのユーザー名とパスワード。
詳細設定を構成します。
パラメーター
説明
connectTimeout
データベース接続のタイムアウト期間 (ミリ秒)。デフォルト値は 900000 ms (15 分) です。
説明JDBC URL に connectTimeout 構成を含める場合、URL で指定されたタイムアウト期間が使用されます。
Dataphin V3.11 より前のバージョンで作成されたデータソースの場合、デフォルトの connectTimeout は
-1で、タイムアウト制限がないことを示します。
socketTimeout
データベースソケットのタイムアウト期間 (ミリ秒)。デフォルト値は 1800000 ms (30 分) です。
説明JDBC URL に socketTimeout 構成を含める場合、URL で指定されたタイムアウト期間が使用されます。
Dataphin V3.11 より前のバージョンで作成されたデータソースの場合、デフォルトの socketTimeout は
-1で、タイムアウト制限がないことを示します。
接続リトライ
データベース接続がタイムアウトした場合、指定されたリトライ回数に達するまで、システムは自動的に接続をリトライします。最大リトライ回数に達しても接続に失敗した場合、接続試行は失敗します。
説明デフォルトのリトライ回数は 1 です。このパラメーターは 0 から 10 までの値に設定できます。
接続リトライ回数は、デフォルトでオフライン統合タスクとグローバル品質チェックに適用されます。グローバル品質チェック機能を使用するには、アセット品質モジュールをアクティブ化する必要があります。オフライン統合タスクの場合、タスクレベルでリトライ回数を構成できます。
[デフォルトリソースグループ] を選択します。このリソースグループは、データベース SQL、オフライン完全データベース移行、データプレビューなど、現在のデータソースに関連するタスクを実行するために使用されます。
[接続テスト] をクリックするか、[OK] をクリックして構成を保存し、PolarDB-X 2.0 データソースを作成します。
[接続テスト] をクリックすると、システムはデータソースが Dataphin に接続できるかどうかをチェックします。[OK] を直接クリックすると、システムは選択したすべてのクラスターの接続を自動的にテストします。選択したすべてのクラスターが接続テストに失敗した場合でも、データソースを作成できます。
[接続テスト] は、Dataphin に登録済みで正常に使用されている [デフォルトクラスター] または [登録済みスケジューリングクラスター] の接続をテストします。[デフォルトクラスター] はデフォルトで選択されており、選択を解除することはできません。[登録済みスケジューリングクラスター] の下にリソースグループがない場合、接続テストはサポートされません。接続をテストする前に、まずリソースグループを作成する必要があります。
選択したクラスターは、現在のデータソースとのネットワーク接続性をテストするためにのみ使用され、後で関連タスクを実行するためには使用されません。
接続テストは通常 2 分未満で完了します。タイムアウトした場合は、
アイコンをクリックして具体的な理由を確認し、リトライできます。テスト結果が [接続に失敗しました]、[接続に成功しました]、または [警告付きで成功] のいずれであっても、システムは最終結果の生成時刻を記録します。
説明[デフォルトクラスター] のテスト結果には、[警告付きで成功]、[接続に成功しました]、[接続に失敗しました] の 3 つの接続ステータスが含まれます。Dataphin の [登録済みスケジューリングクラスター] のテスト結果には、[接続に成功しました] と [接続に失敗しました] の 2 つの接続ステータスのみが含まれます。
テスト結果が [接続に失敗しました] の場合、
アイコンをクリックして具体的な失敗理由を表示できます。テスト結果が [警告付きで成功] の場合、アプリケーションクラスターの接続は成功しましたが、スケジューリングクラスターの接続が失敗したことを意味します。現在のデータソースは、データ開発および統合には使用できません。
アイコンをクリックしてログ情報を表示できます。