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