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