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