データ保護のFIPSコンプライアンス標準をサポートするには、政府のクラウド・リージョンが必要です。政府レルムのデータ変換は、FIPS 140-2 Level 1に準拠しています。サーバー間のセキュアな通信を確保するために、接続ソースがFIPSに準拠していることを確認してください。

ノート

適用先: Data Integrator: Web Editionというマーケットプレイスで別個のリストとして使用できるデータ変換。

• ドライバのインストールが必要なコネクタの場合、接続を追加する前に、jarファイルを/u01/oracle/transforms_home/userlibsディレクトリにコピーする必要があります。
• ここに示されている接続タイプ以外に、JDBCでサポートされている任意のデータ・ソースにデータ変換を接続するために使用できるカスタム・コネクタを作成できます。「カスタム・コネクタの作成」を参照してください。

新しいコネクタを作成するには:

1. 左側のペインで、「管理」をクリックします。

   警告メッセージが表示されます。

2. 「続行」をクリックします。
3. 左側のペインで、「カスタム接続」をクリックします。

   「カスタム接続」画面が表示されます。

4. 「接続タイプの作成」をクリックします。

   「接続タイプの作成」ページが表示されます。

5. 「カテゴリ」ドロップダウンから、データベース、アプリケーションまたはサービスのいずれかを作成する接続のタイプを選択します。
6. 接続の名前を入力します。
7. ソース接続のJDBCドライバーの名前を入力します。たとえば、oracle.jdbc.OracleDriverです。
   ノート
   
   ドライバのインストールが必要なコネクタの場合は、接続を追加する前に、jarファイルを/u01/oracle/transforms_home/userlibsディレクトリにコピーする必要があります。
8. 「OK」をクリックします

リストに新しく作成したカスタム接続が表示され、「接続の作成」ページで使用できます。

次の操作を実行するには、選択した接続の横にある「アクション」アイコン()をクリックします:

• 入力した接続詳細を編集するには、「編集」を選択します。
• 「エクスポート」をクリックすると、接続をエクスポートできます。「オブジェクトのエクスポート」を参照してください。
• 作成した接続を削除するには、「削除」を選択します。
  ノート
  
  既存の接続を持つカスタム・コネクタは削除できません。

データ変換接続を定義するには:

新規に作成した接続が「接続」ページに表示されます。

次の操作を実行するには、選択した接続の横にある「アクション」アイコン()をクリックします:

• 入力した接続詳細を編集するには、「編集」を選択します。
• 作成した接続をテストするには、「接続のテスト」を選択します。
• 「エクスポート」をクリックすると、接続をエクスポートできます。「オブジェクトのエクスポート」を参照してください。
• スキーマを削除するには、「スキーマの削除」を選択します。
• 作成した接続を削除するには、「接続の削除」を選択します。

必要な接続を検索して、次のフィルタに基づいてその詳細を確認することもできます:

• 接続の名前。
• 作成した接続に関連付けられているテクノロジ。

データ変換では、Oracle Object Storage (S3互換性)およびAWS S3ストレージ・サービスがサポートされ、Apache Iceberg表のparquetファイルが格納されます。

Data Transforms Apache Icebergコネクタでは、RESTカタログがすでに存在している必要があります。このRESTカタログは、Iceberg Open API仕様のApache Gravitino (外部リンク)に基づいて設定されます。

• Apache Iceberg接続の作成
• Apache Icebergデータ・ロードの作成および実行

Apache Iceberg接続の作成

REST URLおよび認証詳細(ユーザー名とパスワードなど)を指定することで、Iceberg RESTカタログとのApache Iceberg接続を構成できます。また、よりセキュアなOAuth 2.0認証を使用して接続を作成することもできます。

Apache Iceberg接続を作成するには:

1. ホームページの左側のペインで、「接続」タブをクリックします。

   「接続」ページが表示されます。

2. 「接続の作成」をクリックします

   「接続の作成」ページが表示されます。

3. 次のいずれかを行います。
   • 「タイプの選択」フィールドに、接続タイプの名前を入力します。
   • 「データベース」タブを選択します。
4. 接続タイプとして「Apache Iceberg」を選択します。
5. 「次へ」をクリックします
6. 「接続名」フィールドにはデフォルト名が事前に移入されています。この値は編集可能です。
7. 「カタログ名」テキスト・ボックスに名前を入力します。
8. 「URLの保存」テキスト・ボックスに、RESTサーバーのURLを入力します。<host>:<port>/<ServiceName>/iceberg形式で値を入力します。
9. 「認証」ドロップダウン・セクションで、次のいずれかを実行します:
   • 「なし」を選択します。
   • 「簡易」を選択し、「Rest User」および「Rest Password」を入力します。
   • OAuthを選択し、次の詳細を入力します:
     • 倉庫の場所: データを格納する場所。たとえば、s3://my-bucket/my/table/locationです
     • トークンURI: OAuthトークンをhttp://<host>:<port>の形式で取得するためのURL
     • トークン・パス: OAuthトークンのパス。たとえば、/oauth2/tokenです。
     • クライアントID: OAuthクライアントID。
     • Client Secret: OAuthクライアント・シークレット。
     • 認証スコープ: Gravitinoサーバーへのアクセス時にクライアントに付与される権限。たとえば、test認証スコープ値は、クライアントがGravitino内のテスト・スコープに関連するリソースにアクセスする権限があることを示す場合があります。[オプション]
     • 権限タイプ: 認可サーバーがアクセス・トークンの発行に使用する方法。たとえば、client_credentialsおよびauthorization_codeです。[オプション]
10. 確立された接続をテストするには、「接続のテスト」をクリックします
11. 必要な接続の詳細をすべて入力した後、「作成」をクリックします。

    Apache Iceberg接続は、Oracle Object StorageにIcebergデータを格納するRESTカタログで構成されます。

新規に作成した接続が「接続」ページに表示されます。

選択した接続の横にある「アクション」アイコン()をクリックして、次の操作を実行します:

• 入力した接続詳細を編集するには、「編集」を選択します。
• 作成した接続をテストするには、「接続のテスト」を選択します。
• 「エクスポート」をクリックして、接続をエクスポートします。「オブジェクトのエクスポート」を参照してください。
• スキーマを削除するには、「スキーマの削除」を選択します。
• 作成した接続を削除するには、「接続の削除」を選択します。

必要な接続を検索して、次のフィルタに基づいてその詳細を確認することもできます:

• 接続の名前。
• 作成した接続に関連付けられているテクノロジ。

Apache Icebergデータ・ロードの作成および実行

Oracleなどの任意のSQLベースのソース・データ・ソースのデータ・ロードを作成して、Apache Icebergターゲット表にデータをロードできます。Apache Icebergをターゲット・データ・ソースとして使用するには、接続の名前とネームスペースを指定する必要があります。Apache Icebergのネームスペースは、リレーショナル・データベースのスキーマに似ています。

データ・ロードを作成すると、ソース・スキーマ内のすべての表が「データ・ロード詳細」ページにリストされ、選択した各ソース表のデータを増分的にロード、追加およびマージするためのオプションが表示されます。データ・ロード実行が完了すると、Iceberg表からデータを読み取ることができます。ワークフローにデータ・ロードをステップとして追加し、事前定義された時間間隔でワークフローを実行するスケジュールを作成できます。「新規ワークフローの作成」を参照してください。

Apache Icebergデータ・ロードを作成して実行するには:

1. 次のいずれかを行います。
   • ホーム・ページで、「データのロード」をクリックします。データ・ロードの作成ウィザードが表示されます。

     デフォルト値を置換する場合は「データ・ロードの作成」タブで名前を入力し、摘要を追加してドロップダウンからプロジェクトを選択します。

   • ホームページで「プロジェクト」をクリックし、必要なプロジェクト・タイルをクリックします。左ペインで、「データ・ロード」をクリックし、「データ・ロードの作成」をクリックします。データ・ロードの作成ウィザードが表示されます。
2. デフォルト値を置き換える場合は名前を入力し、説明を追加します。
3. ロード処理では、次のいずれかを実行します。
   • 「内部」ラジオ・ボタンを選択し、「デプロイメント・タイプ」ドロップダウンから「データ変換(バッチ)」を選択します。
   • 「委任」ラジオ・ボタンを選択し、「デプロイメント・タイプ」ドロップダウンからOCI GoldenGateを選択します。GoldenGateデプロイメント接続から接続を選択します。
4. 「次へ」をクリックします
5. 「ソース接続」タブで、次の手順を実行します。
   1. 「接続タイプ」ドロップダウンから、SQLベースのデータ・ソースを選択します。
   2. 「接続」ドロップダウンから、データ・エンティティの追加元となる必要な接続を選択します。
   3. 「次へ」をクリックします
6. 「ターゲット接続」タブで、次の手順を実行します。
   1. 「接続タイプ」ドロップダウンから、接続タイプとして「Apache Iceberg」を選択します。
   2. 「接続」ドロップダウンから、データのロードに使用する接続を選択します。
   3. 「名前空間」を指定します。既存のネームスペースから選択することも、新しいネームスペースを作成することもできます。
   4. 「保存」をクリックします

   「データ・ロードの詳細」ページが表示され、すべてのソース表がリストされます。

7. ロードする必要な表および対応するデータ・ロード操作を選択します。使用できるデータ・ロード・オプションは、「増分マージ」、「増分追加」、「追加」および「ロードしない」です。
8. をクリックして変更を保存します。行の緑色のチェックマーク()は、変更が保存されていることを示します。
9. をクリックして、データ・ロードを実行します。

   データ・ロードが正常に開始されると、確認プロンプトが表示されます。

データ・ロードのステータスを確認するには、ターゲット・スキーマの詳細のすぐ下にある「データ・ロード・ステータス」パネルを参照します。このパネルの詳細は、「データ・ロード、データ・フローおよびワークフローのステータスのモニター」に関する項を参照してください。このパネルには、このデータ・ロードを実行するために実行されるジョブへのリンクが表示されます。「ジョブの詳細」ページで進行状況をモニターするには、リンクをクリックします。ジョブの詳細は、「ジョブの作成および管理」を参照してください。

ロードされたすべての表とその詳細が「データ・エンティティ」ページにリストされます。データ・エンティティの統計を表示するには、データ・エンティティの横にある「アクション」アイコン()をクリックし、「プレビュー」、「統計」タブの順に選択します。詳細は、「データ・エンティティの統計の表示」を参照してください。

Databricksをソースとして使用するには、デルタ共有サーバーのURLと、Delta Lake共有サーバーにアクセスできるBearerトークンを指定する必要があります。Oracle Data Shareをソースとして使用するには、トークン・エンド・ポイントのURLをクライアントIDおよび秘密キーとして指定する必要があります。

• デルタ共有接続の作成
• デルタ共有データ・ロードの作成および実行

デルタ共有接続の作成

デルタ共有接続を定義するには:

1. ホームページの左側のペインで、「接続」タブをクリックします。

   「接続」ページが表示されます。

2. 「接続の作成」をクリックします

   「接続の作成」ページが表示されます。

3. 次のいずれかを行います。
   • 「タイプの選択」フィールドに、接続タイプの名前を入力します。
   • 「データベース」タブを選択します。
4. 接続タイプとして「デルタ共有」を選択します。
5. 「次へ」をクリックします
6. 「接続名」フィールドにはデフォルト名が事前に移入されています。この値は編集可能です。
7. エンドポイントURLの共有テキストボックスに、デルタ共有サーバーのURLを入力します。<host>:<port>/<shareEndpoint>/形式で値を入力します。
8. 「接続」セクションで、次のいずれかを実行します。
   • 「Oracleデータ共有」を選択し、共有にアクセスするための「トークン・エンドポイントURL」、「クライアントID」および「クライアント・シークレット」を指定します。

     この情報は、共有プロバイダから提供されるものからダウンロードする必要があるデルタ共有プロファイルJSONドキュメントから取得できます。(これは、共有エンドポイントURLの取得場所でもあります)

     この情報は、共有にアクセスするためにデータ共有プロバイダが提供するアクティブ化リンクからダウンロードできます。デルタ共有プロファイルJSONドキュメントから入手できます。

   • 「Databricks」を選択し、「Bearerトークン」テキスト・ボックスにデルタ共有サーバーに接続するためのトークンを入力します。
9. プロキシを使用してDelta Share ServerまたはDelta Share Storageにアクセスする必要がある場合は、次の設定を構成します。
   • 「プロキシ・ホスト」テキスト・ボックスに、接続に使用されるプロキシ・サーバーのホスト名を入力します。
   • 「プロキシ・ポート」テキスト・ボックスに、プロキシ・サーバーのポート番号を入力します。
   • プロキシが必要な場所に応じて、次のチェック・ボックスを選択します。
     • プロキシを使用したデルタ共有サーバーへのアクセス
     • プロキシを使用したデルタ共有ストレージへのアクセス
10. 確立された接続をテストするには、「接続のテスト」をクリックします
11. 必要な接続の詳細をすべて入力した後、「作成」をクリックします。

    新しい接続が作成されます。

新規に作成した接続が「接続」ページに表示されます。

次の操作を実行するには、選択した接続の横にある「アクション」アイコン()をクリックします:

• 入力した接続詳細を編集するには、「編集」を選択します。
• 作成した接続をテストするには、「接続のテスト」を選択します。
• 「エクスポート」をクリックして、接続をエクスポートします。「オブジェクトのエクスポート」を参照してください。
• スキーマを削除するには、「スキーマの削除」を選択します。
• 作成した接続を削除するには、「接続の削除」を選択します。

必要な接続を検索して、次のフィルタに基づいてその詳細を確認することもできます:

• 接続の名前。
• 作成した接続に関連付けられているテクノロジ。

デルタ共有データ・ロードの作成および実行

Delta ShareからOracle Autonomous Databaseにデータをロードするには、Oracle接続ユーザーが管理ユーザーである必要があります。Oracleユーザーがデータを作成して別のスキーマの表に挿入できるようにするには、管理権限が必要です。

データ・ロードを実行すると、データ変換によってターゲット・スキーマ内の対応する表にデータがロードされます。データ・ロードは増分的に実行されます。データ・ロードを初めて実行すると、データ変換によってすべてのデータが新しい表にコピーされる。後続のデータ・ロード実行ごとに、変更のみがアップロードされます。レコード内の追加または削除は、ターゲット表に反映されます。表にメタデータの変更がある場合(列の追加など)、データ変換では、ターゲット・サーバーにデータをロードする新しい表が作成されます。ワークフローを作成し、データ・ロードをステップとして追加し、事前定義された時間間隔でワークフローを実行するスケジュールを作成できます。「新規ワークフローの作成」を参照してください。

デルタ共有データ・ロードを作成して実行するには:

1. 次のいずれかを行います。
   • ホーム・ページで、「データのロード」をクリックします。「データ・ロードの作成」ウィザードが表示されます。

     「データ・ロードの作成」タブで、デフォルト値を置換する場合は名前を入力し、摘要を追加してドロップダウンからプロジェクトを選択します。

   • ホーム・ページで「プロジェクト」をクリックし、必要なプロジェクト・タイルを選択します。左側のペインで、「データ・ロード」をクリックし、「データ・ロードの作成」をクリックします。「データ・ロードの作成」ウィザードが表示されます。

     デフォルト値を置き換えて説明を追加する場合は、「データ・ロードの作成」タブに名前を入力します。

2. 「次へ」をクリックします
3. 「ソース接続」タブで、次の手順を実行します。
   1. 「接続タイプ」ドロップダウンから、「共有のデルタ」を選択します。
   2. 「接続」ドロップダウンから、データ・エンティティの追加先となる必要な接続を選択します。
   3. 「共有」ドロップダウンから表をロードする共有を選択します。ドロップダウンには、選択した接続のすべてのシェアがリストされます。
   4. 「次へ」をクリックします
4. 「ターゲット接続」タブで、次の手順を実行します。
   1. 「接続タイプ」ドロップダウンから、接続タイプとして「Oracle」を選択します。
      ノート
      
      このドロップダウンには、JDBCタイプの接続のみがリストされます。
   2. 「接続」ドロップダウンから、データ・エンティティのロード元の必要な接続を選択します。
   3. 「スキーマ」テキスト・ボックスに一意の名前を入力します。
   4. 「保存」をクリックします
   「データ・ロードの詳細」ページに、選択した共有内のすべての表とそのスキーマ名が表示されます。

   ノート
   
   デルタ共有データ・ロードの場合、「データ・ロードの詳細」ページにはオプションのみが含まれます。ターゲット・スキーマにロードする前に、データ・エンティティに様々なマージ、増分追加、再作成、切捨て、追加アクションを適用することはできません。これは、デルタ共有サーバーとターゲット・スキーマ間でデータが一貫していることを確認するためです。
5. をクリックしてデータ・ロードを実行します。

   データ・ロードが正常に開始されると、確認プロンプトが表示されます。

データ・ロードのステータスを確認するには、ターゲット・スキーマの詳細のすぐ下にあるステータス・パネルを参照してください。「ステータス」パネルの詳細は、「データ・ロード、データ・フローおよびワークフローのステータスのモニター」を参照してください。このパネルには、このデータ・ロードを実行するジョブへのリンクが表示されます。「ジョブの詳細」ページで進行状況をモニターするには、リンクをクリックします。ジョブの詳細については、Create and Manage Jobsを参照してください。

ロードされたすべてのデータ・エンティティとその詳細が「データ・エンティティ」ページにリストされます。データ・エンティティの統計を表示するには、データ・エンティティの横にある「アクション」アイコン()をクリックし、「プレビュー」、「統計」タブの順に選択します。詳細は、データ・エンティティの統計の表示を参照してください。

Oracle BICC接続を作成するには、まずBICCコンソールの「OCIオブジェクト・ストレージ接続」タブを使用して外部ストレージを構成する必要があります。Oracle Data Transformsで接続を定義する際に、これらの接続の詳細を指定する必要があります。

BICC接続を使用して、データ・ストアを抽出するオファリングを選択できます。データ変換では、Oracle BICCで使用されるOracle Object Storageデータ・サーバーを使用して、抽出されたファイルをステージングします。これらは、その後マッピングのソースとして使用できます。Oracle BICC接続をマッピングのターゲットとして使用できないことに注意してください。

Oracle BICC接続を定義するには、

新規に作成した接続が「接続」ページに表示されます。

次の操作を実行するには、選択した接続の横にある「アクション」アイコン()をクリックします:

• 入力した接続詳細を編集するには、「編集」を選択します。
• 作成した接続をテストするには、「接続のテスト」を選択します。
• 「エクスポート」をクリックすると、接続をエクスポートできます。「オブジェクトのエクスポート」を参照してください。
• スキーマを削除するには、「スキーマの削除」を選択します。
• 作成した接続を削除するには、「接続の削除」を選択します。

必要な接続を検索して、次のフィルタに基づいてその詳細を確認することもできます:

• 接続の名前。
• 作成した接続に関連付けられているテクノロジ。

Oracle Cloud Infrastructure Generative AI接続を定義するには:

1. ホームページの左側のペインで、「接続」タブをクリックします。

   「接続」ページが表示されます。

2. 「接続の作成」をクリックします

   「接続の作成」ページが表示されます。

3. 「タイプの選択」で、
   • 「名前」フィールドに、新しく作成した接続の名前を入力します。
   • 接続のタイプとして「サービス」を選択します。
4. 「OCI生成AI」および「次」を選択します。
5. 「接続の詳細」に、次の詳細を指定します:
   • OCI URL - OCI生成AIサービスのエンドポイントURL。
   • ユーザーOCID - Oracle Cloud Infrastructure ConsoleのユーザーOCID。
   • テナンシOCID - Oracle Cloud Infrastructure ConsoleからのテナンシOCID。
   • コンパートメントOCID - Oracle Cloud Infrastructure ConsoleからのコンパートメントOCID。
   • 秘密キー - PEM形式の秘密キー。ダウンロードした秘密キー・ファイルへのパスを指定します。
   • フィンガープリント - 追加されたキーのフィンガープリント。
6. 必要なすべての接続の詳細を証明した後、「作成」をクリックします。

   新しい接続が作成されます。

7. 確立された接続をテストするには、「接続のテスト」をクリックします

   構成したOracle Database 23ai接続がリストされたポップアップが表示されます。この接続のテストに使用するオプションを選択します。

   ノート
   
   テスト接続が失敗した場合、問題を修正する手順は、OCI生成AI接続の問題のトラブルシューティングを参照してください。

新しく作成した接続が「接続」ページに表示されます。

OCI生成AI接続の問題のトラブルシューティング

OCI生成AI接続で接続のテストが失敗した場合は、次の操作を実行して問題をトラブルシューティングします:

1. すべての接続情報が正しく入力されていることを確認してください。たとえば、
   • OCI URLサンプル: https://inference.generativeai.us-chicago-1.oci.oraclecloud.com/20231130/actions/embedText
   • 秘密キーのサンプル: MIIEvg......beE/
2. 「接続のテスト」をクリックすると、Oracle接続を選択するように求められます。Oracle 23ai接続であることを確認します。
3. Oracle 23aiデータベースにadminとしてログインし、次の問合せを実行してステータスが有効であることを確認します。

   SELECT object_name, object_type, status
   FROM dba_objects
   WHERE object_name = 'DBMS_VECTOR_CHAIN' AND owner = 'CTXSYS';

4. 次のplsqlブロックがデータベースで機能するかどうかを確認します。データ変換では、plsqlブロックを使用してテスト接続を実行します。

   exec dbms_vector_chain.drop_credential('OCI_CRED');
   declare
     jo json_object_t;
   begin
     -- create an OCI credential
     jo := json_object_t();
     jo.put('user_ocid', '<your user ocid>');
     jo.put('tenancy_ocid', '<your tenancy ocid');
     jo.put('compartment_ocid', '<your compartment ocid');
     jo.put('private_key', '<your private key');
     jo.put('fingerprint', '<your fingerprint>');
     dbms_output.put_line(jo.to_string);
     dbms_vector_chain.create_credential(
       credential_name => 'OCI_CRED',
       params => json(jo.to_string));
   end; 

   select dbms_vector_chain.utl_to_embedding('hello', JSON('{"provider": "ocigenai","credential_name" : "OCI_CRED", "url": "https://inference.generativeai.us-chicago-1.oci.oraclecloud.com/20231130/actions/embedText","model": "cohere.embed-english-light-v2.0"}')) from dual;

   plsqlブロック問合せの実行時にHTTP request failedエラーが発生した場合は、ユーザーにネットワーク・アクセス権を付与してみてください:

   BEGIN
       DBMS_NETWORK_ACL_ADMIN.APPEND_HOST_ACE(
           host => '*',
           ace => xs$ace_type(privilege_list => xs$name_list('connect'),
                              principal_name => '<your username>',
                              principal_type => xs_acl.ptype_db));
   END;

• Oracle ERP Cloud接続は、マッピングのターゲットとして使用できません。
• データ・ロードは、Oracle ERP Cloud接続ではサポートされていません。

• Oracle ERP Cloudサーバー接続の作成
• Oracle ERP Cloudサーバーからのデータ・エンティティ定義のインポート

Oracle ERP Cloudサーバー接続の作成

この接続を作成するには、レポート・サービスのWSDL URLと、ERP Cloudインスタンスに接続するためのユーザー名とパスワードを指定する必要があります。

Oracle ERP Cloudサーバー接続を定義するには:

1. ホームページの左側のペインで、「接続」タブをクリックします。

   「接続」ページが表示されます。

2. 「接続の作成」をクリックします

   「接続の作成」ページが表示されます。

3. 次のいずれかを行います。
   • 「タイプの選択」フィールドに、接続タイプの名前を入力します。
   • 「アプリケーション」タブを選択します。
4. 接続タイプとして「Oracle ERP Cloud」を選択します。
5. 「次へ」をクリックします
6. 「接続名」フィールドにはデフォルト名が事前に移入されています。この値は編集可能です。
7. 「WSDL URL」テキスト・ボックスに、Oracle ERP Cloudインスタンスに使用されるBI Publisher WebサービスのURLを入力します。URLの形式はBI Publisher Hostname/xmlpserver/services/PublicReportWSSService?wsdlです。

   たとえば: https://fa-eudu-saasfademo1.ds-fa.oraclepdemos.com/xmlpserver/services/PublicReportWSSService?wsdl。

8. 「プロキシ・ホスト」テキスト・ボックスに、接続に使用されるプロキシ・サーバーのホスト名を入力します。
9. 「プロキシ・ポート」テキスト・ボックスに、プロキシ・サーバーのポート番号を入力します。
10. 「ユーザー」テキスト・ボックスに、Oracle ERP Cloudインスタンスに接続するためのユーザー名を入力します。
11. 「パスワード」テキスト・ボックスに、Oracle ERP Cloudインスタンスに接続するためのパスワードを入力します。
12. 必要なすべての接続の詳細を指定した後、「接続のテスト」をクリックして接続をテストします。
13. 「作成」をクリックします

    新しく作成した接続が「接続」ページに表示されます。

    選択した接続の横にある「アクション」アイコン()をクリックして、次の操作を実行します:

    • 入力した接続詳細を編集するには、「編集」を選択します。
    • 作成した接続をテストするには、「接続のテスト」を選択します。
    • 「エクスポート」をクリックすると、接続をエクスポートできます。「オブジェクトのエクスポート」を参照してください。
    • スキーマを削除するには、「スキーマの削除」を選択します。
    • 作成した接続を削除するには、「接続の削除」を選択します。

    必要な接続を検索して、次のフィルタに基づいてその詳細を確認することもできます:

    • 接続の名前。
    • 作成した接続に関連付けられているテクノロジ。

Oracle ERP Cloudサーバーからのデータ・エンティティ定義のインポート

Oracle ERP Cloud接続の場合、「データ・エンティティのインポート」ページには、キーと値のペアでの入力が必要です。データをインポートするには、BIサーバー上のBIパブリッシャ・レポートの場所を参照するBIPReportLocationキーを指定する必要があります。この情報は、対応するレポートが開いているときにBIサーバーで確認できます。

Oracle Financials Cloud接続を定義するには、

新規に作成した接続が「接続」ページに表示されます。

次の操作を実行するには、選択した接続の横にある「アクション」アイコン()をクリックします:

• 入力した接続詳細を編集するには、「編集」を選択します。
• 作成した接続をテストするには、「接続のテスト」を選択します。
• 「エクスポート」をクリックすると、接続をエクスポートできます。「オブジェクトのエクスポート」を参照してください。
• スキーマを削除するには、「スキーマの削除」を選択します。
• 作成した接続を削除するには、「接続の削除」を選択します。

必要な接続を検索して、次のフィルタに基づいてその詳細を確認することもできます:

• 接続の名前。
• 作成した接続に関連付けられているテクノロジ。

• データ・ウェアハウスの構築に必要なアクセス権限の構成
• Oracle NetSuite接続の作成
• 「データ・ウェアハウスの構築」ウィザードの使用
• ターゲット・スキーマにデータをロードするための事前構築済ワークフローの実行

データ・ウェアハウスの構築に必要なアクセス権限の構成

NetSuite接続を作成するか、データ変換でデータ・ウェアハウスの構築ウィザードを使用する前に、管理者としてNetSuiteにログインし、SuiteAnalytics Connectを有効にして、カスタム・ロールを作成し、NetSuiteデータ・ウェアハウスの構築に必要なアクセス権限を設定する必要があります。

アクセス権限を構成するには:

1. 次のURLを使用して、NetSuiteに管理者としてログインします。

   https://system.netsuite.com/pages/customerlogin.jsp

2. SUITEANALYTICS CONNECT機能が有効になっているかどうかを確認します。

   「設定」→「会社」→「機能の有効化」に移動します。「アナリティクス」タブをクリックし、「SuiteAnalytics Connect」ボックスにチェックマークが入っていることを確認します。

3. カスタム・ロールを追加します。

   「設定」>「ユーザー/ロール」>「ユーザー管理」>「ロールの管理」に移動します。「新規ロール」をクリックし、必要な詳細を追加し、「保存」をクリックしてカスタム・ロールを作成します。

4. 必要な権限をカスタム・ロールに割り当てます。

   「設定」>「ユーザー/ロール」>「ユーザー管理」>「ロールの管理」に移動します。SuiteAnalytics Connect権限を追加するカスタム・ロールの名前の横にある「カスタマイズ」をクリックします。

   「権限」タブの「トランザクション」タブをクリックし、次の権限を割り当てます。

   • アカウントの詳細
   • 会計リスト
   • 会計管理
   • アカウント
   • 買掛管理
   • 買掛金グラフ化
   • 買掛金登録表
   • 売掛金
   • 売掛金グラフ化
   • 売掛金登録表
   • 在庫調整
   • 在庫ワークシートを調整
   • 償却レポート
   • 償却スケジュール
   • 監査証跡
   • 貸借対照表
   • 銀行口座登録表
   • 発注書に基づき請求書を作成
   • 請求予定表
   • 請求
   • 保管棚棚入ワークシート
   • 保管棚移動
   • 一括発注書
   • アセンブリの構成
   • CRMグループ
   • カレンダ
   • 現金販売
   • 現金売上払戻
   • 手数料
   • 手数料- 実行ルール
   • 課金ルール
   • Check
   • クラス
   • コミッション機能の設定
   • コミッション・レポート
   • 注文確定
   • 給与のコミット
   • 競合会社
   • コンポーネント使用箇所
   • 担当者
   • 在庫棚卸
   • 経費配賦表を作成
   • クレジット・カード
   • クレジット・カード払戻
   • クレジット・カード登録表
   • クレジット・メモ
   • クレジット返品
   • Currency
   • 通貨再評価
   • カスタム認識イベントの種類
   • 顧客預入
   • 顧客支払
   • 顧客払戻
   • 顧客
   • 繰延経費精算書
   • 削除済レコード
   • Departments (部門)
   • 前払い金
   • 預入消込
   • ドキュメントおよびファイル
   • 売上予想を編集
   • マネージャ予測の編集
   • 電子メール・テンプレート
   • 従業員コミッション・トランザクション
   • 従業員コミッション・トランザクション承認
   • 従業員レコード
   • 従業員リマインダ
   • Employees (従業員)
   • 開始残高の入力
   • 前払金/買掛金調整の入力
   • 資本登録表
   • 目標の設定
   • 見積
   • イベント
   • 経費精算書
   • 費用
   • リストのエクスポート
   • 公正価値の特性
   • 公正価値計算式
   • 公正価格
   • 財務諸表
   • トランザクションを検索
   • 固定資産登録表
   • 注文を配送
   • 配送リクエスト
   • 総勘定元帳
   • 価格表の生成
   • ステートメントの生成
   • インポート済従業員経費
   • インバウンド出荷
   • 収入
   • 損益計算表
   • 在庫
   • 在庫ステータスの変更
   • インボイス
   • 請求書の承認
   • 請求書注文書
   • 品目履行
   • 品目受入
   • 品目収益カテゴリ
   • アイテム
   • リード・スナップショット/リマインダ
   • 場所
   • 長期負債登録表
   • 仕訳入力を作成
   • 会計期間の管理
   • 給与の管理
   • 一括更新
   • 定期トランザクション
   • モバイル・デバイスのアクセス
   • 純資産
   • 非転記登録表
   • 「ノート」タブ
   • 商談
   • その他の資産登録表
   • その他の流動資産登録表
   • その他の流動負債登録表
   • その他のリスト
   • その他の名称
   • 所有権移転
   • 請求支払
   • 消費税の支払
   • 税金負債の支払
   • 給与仕訳帳
   • 給与アイテム
   • 検索の実行
   • 通話
   • 仕入先支払請求書差異を転記
   • トランザクションの転記期間
   • 価格表
   • 価格プラン
   • 給与の処理
   • プロジェクト収益ルール
   • 購買契約
   • 発注書
   • 発注レポート
   • 購入
   • 調整
   • 照合レポート
   • 返品の払戻
   • レポートのカスタマイズ
   • レポート・スケジューリング
   • 見積依頼
   • 購買申請
   • リソース
   • 返品承認
   • 在庫費用を再評価
   • 収益計上処理
   • 収益計上処理の承認
   • 収益要素
   • 収益認識フィールド・マッピング
   • 収益認識プラン
   • 収益認識レポート
   • 収益認識ルール
   • 収益認識スケジュール
   • SOAP Webサービス
   • 販売
   • パートナー別売上
   • プロモーション別売上
   • 注文書
   • 注文書承認
   • 注文書配送レポート
   • 販売オーダー・レポート
   • 受注取引レポート
   • 予算の設定
   • SOAP Webサービスの設定
   • 計算書手数料
   • 統計勘定科目登録
   • ストア・ピックアップ履行
   • 登録変更指示
   • 登録プラン
   • サブスクリプション
   • 子会社
   • SuiteAnalytics Connect
   • SuiteAnalyticsワークブック
   • タスク
   • Tax
   • メッセージのトラッキング
   • トランザクション詳細
   • 資金振替
   • 在庫の転送
   • 移動伝票
   • 転送オーダー承認
   • 試算表
   • 未請求売掛金登録表
   • アセンブリの解体
   • Units
   • 仕入先支払請求書の承認
   • 仕入先支払承認
   • 仕入先への見積リクエスト
   • 仕入先返品承認
   • ベンダー返品承認
   • ベンダー返品
   • 仕入先
   • 勤務カレンダ
   • ワーク・オーダー
   • 作業オーダー・クローズ
   • 作業オーダー完了
   • ワーク・オーダー発行
5. 「SuiteAnalytics Connect– すべて読取り」権限を追加します。

   「設定」タブの下の「権限」タブをクリックし、ドロップダウンから「SuiteAnalytics Connect– すべて読取り」を選択して、「追加」をクリックします。

6. 「保存」をクリックして、これらの権限をカスタム・ロールに適用します。
7. ユーザーへのカスタム・ロールの割当て。データ変換からNetSuiteへの接続を作成する場合は、このユーザーの資格証明を入力してデータ・サーバーに接続する必要があります。接続の作成の詳細は、「Oracle NetSuite接続の作成」を参照してください。

   ユーザーにカスタム・ロールを割り当てるには、「設定」>「ユーザー/ロール」>「ユーザーの管理」に移動します。ユーザー名の横にある「編集」をクリックし、カスタム・ロールを割り当てて、「保存」をクリックします。

8. アクセス権限を確認するには、カスタム・ロールが割り当てられているユーザーとしてログインします。

   「分析」>「データセット」に移動します。「新規データセット」をクリックします。このページには、ユーザーがアクセスできるすべてのテーブルおよびレコード タイプがリストされます。たとえば、トランザクション表を検索して、ユーザーがトランザクション表にアクセスできるかどうかを確認します。

Oracle NetSuite接続の作成

JDBC接続の認証またはOAuth 2.0認証を使用して、Oracle NetSuite接続を作成できます。

Oracle NetSuite接続を定義するには:

1. ホームページの左側のペインで、「接続」タブをクリックします。

   「接続」ページが表示されます。

2. 「接続の作成」をクリックします

   「接続の作成」ページが表示されます。

3. 次のいずれかを行います。
   • 「タイプの選択」フィールドに、接続タイプの名前を入力します。
   • 「アプリケーション」タブを選択します。
4. 接続タイプとして「Oracle NetSuite」を選択します。
5. 「次へ」をクリックします
6. 「接続名」フィールドにはデフォルト名が事前に移入されています。この値は編集可能です。
7. 接続の詳細を指定するには、次のいずれかを実行します。
   • JDBC接続を使用するには、次の詳細を指定します。
     • JDBC URL - 接続に使用するSuiteAnalytics ConnectサーバーのURLを入力します。
     • ユーザー - データ・サーバーに接続するためのユーザー名を入力します。
     • 「パスワード」テキスト・ボックスで、データ・サーバーに接続するためのパスワードを入力します。
     • 「アカウントID」テキスト・ボックスに、データ・サーバーに接続するためのアカウントIDを入力します。
     • 「ロールID」テキスト・ボックスに、データ・サーバーに接続するためのロールIDを入力します。
   • OAuth 2.0認証を使用するには、OAuth 2.0スイッチをクリックし、次の詳細を指定します:
     • ユーザー名 - OAuth 2.0接続を使用してNetSuiteにログインするためのロール・アクセス権を持つユーザーの名前を入力します。これは、データ・ウェアハウスの構築に必要なアクセス権限の構成でカスタム・ロールを割り当てたユーザーです。
     • アカウントID - データ・サーバーに接続するためのアカウントIDを入力します。この情報を取得するには、NetSuiteアカウントにログインし、SuiteAnalytics接続情報を表示します。
     • ロールID - データ・サーバーに接続するためのロールIDを入力します。この情報を取得するには、NetSuiteアカウントにログインし、SuiteAnalytics接続情報を表示します。
     • クライアントID - データ・サーバーに接続するためのクライアントIDを入力します。

       クライアントIDを取得するには、OAuth 2.0クライアント資格証明フローを有効にして、NetSuiteに統合レコードを作成します。統合レコードが正常に作成されたときに表示されるクライアントIDをコピーして保存します。

       ノート
       
       NetSuiteは、NetSuite OAuth 2.0クライアント資格証明フローのトークン署名用のRSA PKCSv1.5スキームをサポートしなくなりました。RSA PKCSv1.5スキームに依存する統合は、RSA-PSSスキームを使用するように更新する必要があります。詳細は、Oracle NetSuiteのドキュメントを参照してください。
     • 公開証明書および秘密キー - OpenSSLコマンドを使用して、必要なPEM形式でキー・ペアを生成します。例

       openssl req -new -x509 -newkey rsa:4096 -keyout private.pem -sigopt rsa_padding_mode:pss -sha256 -sigopt rsa_pss_saltlen:64 -out public.pem -nodes -days 365

       「パブリック証明書」フィールドにpublic.pemの内容を貼り付けます。「秘密キー」フィールドにprivate.pemの内容を貼り付けます。

     • 証明書ID - データ・サーバーに接続するための証明書IDを入力します。

       証明書IDを取得するには、NetSuite OAuth 2.0クライアント資格証明(M2M)設定を使用して、公開証明書ファイル(auth-cert.pem)を証明書キー・リストに追加し、生成された証明書IDをコピーします。

8. マッピングに使用するソースが保存検索の場合は、「保存検索抽出」で次の詳細も指定する必要があります:
   • アプリケーションID: データ変換のNetSuiteアプリケーションIDを入力します。
   • バージョン: NetSuiteバージョン番号を入力します。
9. 「データ・モデルの構築」のチェック・ボックスを選択して、NetSuiteからデータを抽出し、「データ・ウェアハウスの構築」ウィザードを使用してOracleターゲット・スキーマに移動します。
10. 「接続のテスト」をクリックして、確立された接続をテストします。
11. 必要なすべての接続の詳細を指定した後、「作成」をクリックします。

    新しい接続が作成されます。

新規に作成した接続が「接続」ページに表示されます。

次の操作を実行するには、選択した接続の横にある「アクション」アイコン()をクリックします:

• 入力した接続詳細を編集するには、「編集」を選択します。
• 作成した接続をテストするには、「接続のテスト」を選択します。
• 「データ・ウェアハウスの構築」を選択して機能領域を選択し、ターゲット・スキーマにNetSuiteデータ・ウェアハウスを作成します。詳細は、「「データ・ウェアハウスの構築」ウィザードの使用」を参照してください。
• 「エクスポート」をクリックして、接続をエクスポートします。「オブジェクトのエクスポート」を参照してください。
• スキーマを削除するには、「スキーマの削除」を選択します。
• 作成した接続を削除するには、「接続の削除」を選択します。

必要な接続を検索して、次のフィルタに基づいてその詳細を確認することもできます:

• 接続の名前。
• 作成した接続に関連付けられているテクノロジ。

「データ・ウェアハウスの構築」ウィザードの使用

NetSuiteアカウントのデータは、分析ウェアハウスのビジネス領域またはサブジェクト領域にグループ化されます。「データ・ウェアハウスの構築」ウィザードを使用すると、新しく作成したデータ・ウェアハウスに含める領域を選択できます。

「データ・ウェアハウスの構築」ウィザードを使用するには:

1. ホームページで、「接続」タブをクリックします。「接続」ページが表示されます。
2. データ・ウェアハウスを構築するために使用するOracle NetSuite接続の横にある「アクション」アイコン()をクリックし、「データ・ウェアハウスの構築」をクリックします。

   「データ・ウェアハウス構築」ウィザードが開きます。

3. 「接続」ドロップダウン・リストから、ターゲット・スキーマが存在するAutonomous Database接続を選択します。
4. 「ステージング・スキーマ」ドロップダウンに、選択した接続に対応するすべてのスキーマが2つのグループで表示されます:
   • 既存のスキーマ(Oracle Data Transformsにインポートしたスキーマ)および
   • 新規データベース・スキーマ(まだインポートしていないスキーマ)。
   使用するスキーマをドロップダウンから選択します。
5. 同様に、「ターゲット・スキーマ」を選択します。
6. 「次へ」をクリックします。
7. NetSuiteデータ・ウェアハウスからターゲット・スキーマへのデータの転送に使用するNetSuiteビジネス・エリアを選択します。
8. 「保存」をクリックします。

   データ変換により、データ・ウェアハウスを構築するプロセスが開始されます。「ホーム」ページの左側のペインで「ジョブ」をクリックして、プロセスの進捗をモニターします。ジョブが正常に完了すると、データ変換により、NetSuite接続からターゲット・スキーマにデータを転送するために実行できる、事前構築されたすべてのワークフローおよびデータ・フローを含む「プロジェクト」フォルダが作成されます。詳細は、「ターゲット・スキーマにデータをロードするための事前構築済ワークフローの実行」を参照してください。

ターゲット・スキーマにデータをロードするための事前構築済ワークフローの実行

「データ・ウェアハウスの構築」ウィザードが正常に完了すると、データ変換により、NetSuite接続からデータを抽出してターゲット・スキーマにロードするために実行できる事前構築済データ・フローおよびワークフローがすべて含まれるプロジェクトが作成されます。

事前構築済ワークフローを表示および実行するには:

1. 「ホーム」ページの左側のペインで「プロジェクト」をクリックし、新しく作成したNetSuiteプロジェクトを選択します。
2. 左側のペインで「ワークフロー」をクリックします。次の事前構築済ワークフローが「プロジェクト詳細」ページにリストされます:
   • NetSuiteソースのSDSへのステージング
   • トランザクション主キーの抽出
   • ウェアハウスへのSDSのロード
   • 削除の適用
   • すべてのワークフロー
3. 実行するワークフローの横にある「アクション」アイコン()をクリックし、「開始」をクリックします。

   Oracleでは、「すべてのワークフロー」を実行して、すべての事前作成ワークフローを実行することをお薦めします。

   ワークフローのステータスを確認するには、現在のプロジェクトの左ペインから「ジョブ」をクリックします。ジョブが正常に完了すると、NetSuite接続のすべてのデータがターゲット・スキーマにロードされます。

OCI Object Storageの専用エンドポイント機能により、OCIのお客様はストレージ・バケットにセキュアにアクセスできます。詳細は、オブジェクト・ストレージの専用エンドポイントを参照してください。データ変換でオブジェクト・ストレージ接続を作成する場合は、新しいURL形式を使用する必要があります。オブジェクト・ストレージ接続がすでにあるユーザーの場合、既存のURLは新しいURL形式に自動的に更新されます。

Oracle Object Storage接続を作成するには、Oracle Cloud Infrastructureのユーザー名および認証トークンが必要です。認証トークンを生成する方法の詳細は、「認証トークンの取得」を参照してください。Oracle Data Transformsで接続を定義する際に、これらの詳細を指定する必要があります。

次の点に注意してください。

• Oracle Object Storage接続を使用してデータ変換にデータをインポートするには、パブリックIPアドレスを使用してコンピュート・ノードにアクセスする必要があります。Object StorageサービスへのアクセスにプライベートIPアドレスを使用する場合は、インターネットにアクセスできることを確認してください。
• Oracle Object StorageからAutonomous Database(およびその逆)にデータをロードするためにサポートされているファイル形式はCSVです。
• サポートされているデータ型は、Numeric、Double、StringおよびDateです。
• データ・ロードはOracle Object Storage接続ではサポートされていません。
• オブジェクト・ストレージへのマッピングを作成するには、ソース・テクノロジがDBMS_CLOUDパッケージをサポートしている必要があります。そうしないと、マッピングは失敗します。
• データ変換では、オブジェクト・ストレージのレルム間接続はサポートされていません。たとえば、Government Cloudリージョンで構成されているデータ変換から、商用レルムにあるオブジェクト・ストレージに接続することはできません。

Oracle Object Storage接続を定義するには、

新規に作成した接続が「接続」ページに表示されます。

次の操作を実行するには、選択した接続の横にある「アクション」アイコン()をクリックします:

• 入力した接続の詳細を編集するには、「編集」を選択します。
• 作成された接続をテストするには、「接続のテスト」を選択します。
• 接続をエクスポートするには、「エクスポート」をクリックします。「オブジェクトのエクスポート」を参照してください。
• スキーマを削除するには、「スキーマの削除」を選択します。
• 作成したコネクションを削除するには、「コネクションの削除」を選択します。

必要な接続を検索して、次のフィルタに基づいてその詳細を確認することもできます:

• 接続の名前。
• 作成された接続に関連付けられているテクノロジ。

汎用RESTコネクタを作成するには、エンドポイントに接続するためのJDBC URL、ユーザー名およびパスワードを指定する必要があります。データ・エンティティのインポート元となる認証方法、エンドポイント、表などの情報を含む構成ファイルを作成およびアップロードすることもできます。

• 汎用REST接続の作成
• 構成ファイルを使用した汎用Rest接続の作成

新しく作成した接続が「接続」ページに表示されます。

次の操作を実行するには、選択した接続の横にある「アクション」アイコン()をクリックします:

• 入力した接続の詳細を編集するには、「編集」を選択します。
• 作成された接続をテストするには、「接続のテスト」を選択します。
• 接続をエクスポートするには、「エクスポート」をクリックします。「オブジェクトのエクスポート」を参照してください。
• スキーマを削除するには、「スキーマの削除」を選択します。
• 作成したコネクションを削除するには、「コネクションの削除」を選択します。

必要な接続を検索して、次のフィルタに基づいてその詳細を確認することもできます:

• 接続の名前。
• 作成された接続に関連付けられているテクノロジ。

汎用REST接続の作成

この接続を作成するには、RESTサービスURLを指定し、リバース・エンジニアリング操作後にデータ変換でデータ・エンティティを作成できる一時スキーマを選択する必要があります。

RESTサーバー接続を定義するには:

1. ホームページの左側のペインで、「接続」タブをクリックします。

   「接続」ページが表示されます。

2. 「接続の作成」をクリックします。

   「接続の作成」ページ・スライド・イン。

3. 次のいずれかを行います。
   • 「タイプの選択」フィールドに、接続タイプの名前または名前の一部を入力します。
   • 「アプリケーション」タブを選択します。
4. 接続タイプとして「汎用Rest」を選択します。
5. 「次へ」をクリックします。
6. 「接続名」フィールドにはデフォルト名が事前に移入されています。この値は編集可能です。
7. 「REST Service URL」テキストボックスに、RESTリソースにサービスを提供するエンドポイントのURLを入力します。
8. 「クライアント・ホスト」テキスト・ボックスで、接続に使用されるプロキシ・サーバーのホスト名を入力します。
9. 「プロパティ・ポート」テキスト・ボックスで、プロキシ・サーバーのポート番号を入力します。
10. 「ユーザー」テキスト・ボックスに、RESTエンドポイントに接続するためのユーザー名を入力します。
11. 「パスワード」テキスト・ボックスに、RESTエンドポイントに接続するためのパスワードを入力します。
12. ステージング接続ドロップダウン・リストから接続を選択します。リストには、既存のAutonomous Database接続のみが表示されます。別の接続を使用するには、このページが表示される前に接続を作成します。
13. 必要なすべての接続の詳細を指定した後、「接続のテスト」をクリックして接続をテストします。
14. 「作成」をクリックします

    新しい接続が作成されます。

構成ファイルを使用した汎用Rest接続の作成

適用先: Data Integrator: Web Editionというマーケットプレイスで別個のリストとして利用できるデータ変換。

汎用RESTコネクタを作成するには、JDBC URL、ユーザー名、パスワードおよび構成ファイルが必要です。構成ファイルは、RESTサーバー接続の作成時にアップロードする必要があるfile_name.restネーミング規則を持つモデル・ファイルです。構成ファイルを作成するには、エンドポイント、表マッピングおよび認証方法を指定する必要があります。構成ファイルは、任意のテキスト・エディタを使用して作成できます。