このトピックでは、GBase 8c データソースを作成する方法について説明します。これにより、Dataphin は GBase 8c からビジネスデータを読み取ったり、GBase 8c にデータを書き込んだりできるようになります。
制限事項
「データソースの作成」権限を含むカスタムグローバルロールを持つユーザー、または「スーパー管理者」、「データソース管理者」、「ワークスペースアーキテクト」、「プロジェクト管理者」のシステムロールを持つユーザーのみがデータソースを作成できます。
操作手順
Dataphin のホームページで、上部のメニューバーから [管理センター] > [データソース管理] を選択します。
[データソース] ページで、[+ 新しいデータソース] をクリックします。
[新しいデータソース] ページの [リレーショナルデータベース] セクションで、[GBase 8c] を選択します。
最近 GBase 8c を使用したことがある場合は、[最近使用したもの] セクションから [GBase 8c] を選択することもできます。または、検索ボックスに GBase 8c と入力してすばやく見つけることもできます。
[新しい GBase 8c データソース] ページで、データソースの接続パラメーターを構成します。
データソースの基本情報を構成します。
パラメーター
説明
データソース名
命名規則は以下の通りです：
中国語文字、大文字と小文字の英字、数字、アンダースコア (_)、ハイフン (-) のみ使用できます。
長さは 64 文字を超えることはできません。
データソースコード
データソースコードを構成すると、Flink_SQL タスクで
DataSourceCode.TableNameまたはDataSourceCode.schema.TableNameのフォーマットを使用してデータソース内のテーブルを参照できます。現在の環境のデータソースに自動的にアクセスするには、変数フォーマット${DataSourceCode}.tableまたは${DataSourceCode}.schema.tableを使用します。詳細については、「Dataphin データソースのテーブルを開発する」または「」をご参照ください。重要データソースコードは一度構成すると変更できません。
データソースコードを構成した後にのみ、アセットディレクトリおよびアセットチェックリストのオブジェクト詳細ページでデータをプレビューできます。
現在、Flink SQL では MySQL、Hologres、MaxCompute、Oracle、StarRocks、Hive、SelectDB、および GaussDB データウェアハウスサービス (DWS) のデータソースのみがサポートされています。
データソースの説明
GBase 8c データソースの説明です。128 文字を超えることはできません。
データソース構成
本番環境と開発環境で個別のデータソースを使用するかどうかを指定します：
個別のデータソースを使用する場合は、[本番 + 開発データソース] を選択します。
個別のデータソースを使用しない場合は、[本番データソース] を選択します。
タグ
データソースを分類するためにタグを追加できます。タグの作成方法の詳細については、「データソースタグの管理」または「」をご参照ください。
データソースと Dataphin 間の接続パラメーターを構成します。
[データソース構成] を [本番 + 開発データソース] に設定した場合は、両方の環境の接続情報を構成する必要があります。[本番データソース] に設定した場合は、本番データソースの接続情報のみを構成します。
説明通常、環境の隔離を確保し、開発環境が本番環境に与える影響を軽減するために、本番データソースと開発データソースは異なるものにすべきです。ただし、Dataphin では、同じパラメーター値を使用して両方の環境に同じデータソースを使用することもできます。
[設定方法] では、[JDBC URL] または [ホスト] を選択できます。デフォルトでは JDBC URL が選択されています。
JDBC URL 構成方法
パラメーター
説明
JDBC URL
エンドポイントのフォーマットは
jdbc:gbase8c://host:port/databaseです。スキーマ
ユーザー名に関連付けられたスキーマを入力します。
ユーザー名とパスワード
認証用のユーザー名とパスワードを入力します。タスクが正しく実行されるように、ユーザーが必要なデータ権限を持っていることを確認してください。
ホスト構成方法
ホスト構成方法
パラメーター
説明
サーバーアドレス
サーバーの IP アドレスとポート番号を入力します。
[+ 追加] をクリックして、複数の IP アドレスとポート番号を追加できます。
アイコンをクリックして余分なエントリを削除します。少なくとも 1 つのエントリを保持する必要があります。dbname
データベース名を入力します。
パラメーター設定
パラメーター
説明
パラメーター
パラメーター名：既存のパラメーター名を選択するか、カスタム名を入力できます。
カスタムパラメーター名には、大文字と小文字の英字、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) のみ使用できます。
パラメーター値：パラメーター名を選択した場合に必須です。大文字と小文字の英字、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) のみ使用できます。値は 256 文字を超えることはできません。
説明[+ パラメーターの追加] をクリックして、複数のパラメーターを追加できます。
アイコンをクリックして余分なパラメーターを削除します。最大 30 個のパラメーターを追加できます。スキーマ
ユーザー名に関連付けられたスキーマを入力します。
ユーザー名、パスワード
GBase 8c データベースにログインするためのユーザー名とパスワードです。
説明ホスト構成方法を選択し、データソース作成後に JDBC URL 方法に切り替えた場合、システムはサーバーの IP アドレスとポート番号を自動的に組み合わせて JDBC URL を生成します。
データソースの詳細設定を構成します。
パラメーター
説明
socketTimeout
データベースのソケットタイムアウト時間 (ミリ秒)。デフォルト値は 1,800,000 ms (30 分) です。
説明JDBC URL に socketTimeout の設定が含まれている場合、その値が使用されます。
Dataphin V3.11 より前に作成されたデータソースの場合、デフォルトの socketTimeout は
-1で、タイムアウトなしを意味します。
connectTimeout
データベースの接続タイムアウト時間 (ミリ秒)。デフォルト値は 900,000 ms (15 分) です。
説明JDBC URL に connectTimeout の設定が含まれている場合、その値が使用されます。
Dataphin V3.11 より前に作成されたデータソースの場合、デフォルトの connectTimeout は
-1で、タイムアウトなしを意味します。
接続リトライ
データベース接続がタイムアウトした場合、システムは指定された回数まで自動的に接続をリトライします。最大リトライ回数を超えても接続に失敗した場合、接続は失敗します。
説明デフォルトのリトライ回数は 1 です。このパラメーターは 0 から 10 の範囲で設定できます。
接続リトライ回数は、デフォルトでバッチ統合タスクとグローバル品質ルール (アセット品質機能が必要) に適用されます。バッチ統合タスクでは、タスクレベルでリトライ回数を構成できます。
説明重複するパラメーター値の優先順位：
パラメーターが [JDBC URL]、[詳細設定]、および [ホスト] 構成で設定されている場合、[JDBC URL] の値が優先されます。
パラメーターが [JDBC URL] と [詳細設定] の両方で設定されている場合、[JDBC URL] の値が優先されます。
パラメーターが [詳細設定] と [ホスト] 構成の両方で設定されている場合、[詳細設定] の値が優先されます。
[デフォルトリソースグループ] を選択します。このリソースグループは、データベース SQL 文の実行、バッチでのデータベース全体の移行、データのプレビューなど、データソースに関連するタスクを実行するために使用されます。
[接続をテスト] をクリックするか、[OK] をクリックして設定を保存し、GBase 8c データソースを作成します。
[接続をテスト] をクリックすると、システムは Dataphin への接続をテストします。[OK] を直接クリックすると、システムは選択されたすべてのクラスターの接続を自動的にテストします。接続テストが失敗した場合でも、データソースを作成できます。