Oracleをデータパイプラインソースとして設定 ​

SuiteAnalytics Connectサービスを使用してレコードを抽出し、宛先に同期するために、Oracleをデータパイプラインソースとして設定します。 このガイドには、NetSuite2をソースとして使用するためのコネクション設定、パイプライン構成、主要な動作が含まれています。

サポートされている機能 ​

Oracleをデータパイプラインソースとして使用する場合、次の機能がサポートされます。

• Oracleデータベーステーブルからのデータ抽出
• 完全同期および増分同期のサポート
• テーブル抽出のフィールドレベル選択
• スキーマドリフトの検出と処理
• フィールドレベルのデータマスキング

前提条件 ​

Oracleコネクションを作成する前に、次の設定があることを確認してください。

• Oracleデータベースインスタンスへのアクセス

• パイプラインで使用されるテーブルへの読み取りアクセス権を持つデータベースユーザー

• 次のコネクション詳細:

  • データベースホスト
  • データベースポート（通常は1521）
  • データベース名（SIDまたはサービス名）
  • データベースのユーザー名とパスワード

• Oracleデータベースがプライベートネットワーク内で実行されている場合は、オンプレミスエージェントが設定され、アクティブであることを確認してください。

接続方法 ​

Oracleコネクションを作成するには、次の手順を実行します。

• ステップ1: Oracleデータベースユーザーを設定する。
• ステップ2: OracleをWorkatoに接続する。

ステップ1: Oracleデータベースユーザーを設定する ​

最低限、データベースユーザーアカウントには、コネクション設定で指定されたデータベースに対するSELECT権限が必要です。 権限を設定するには、次の例を参照してください。

権限の設定方法を確認するには、ここをクリックしてください

Oracleインスタンス内の名前付きスキーマ（HR_PROD）に、新しいデータベースユーザーWORKATOを使用して接続する場合、次のサンプルクエリを使用できます。

まず、Workatoでの連携ユースケース専用の新しいユーザーを作成します。

CREATE USER WORKATO IDENTIFIED BY password

次に、このユーザーにCONNECTを付与します。

GRANT CONNECT TO WORKATO;

これにより、ユーザーはOracleインスタンスへのログインアクセス権を持つことができます。 ただし、このユーザーはどのテーブルにもアクセスできません。

次のステップでは、HR_PRODスキーマのSUPPLIERテーブルへのアクセス権を付与します。 この例では、SELECT権限とINSERT権限のみを付与します。

GRANT SELECT,INSERT ON HR_PROD.SUPPLIER TO WORKATO;

最後に、このユーザーに必要な権限があることを確認します。 すべての権限付与を確認するクエリを実行します。

SELECT * FROM DBA_ROLE_PRIVS WHERE GRANTEE = 'WORKATO';
SELECT * FROM DBA_TAB_PRIVS WHERE GRANTEE = 'WORKATO';

これにより、WorkatoでOracleコネクションを作成するための次の最小権限が返されます。

+---------+--------------+--------------+--------------+
| GRANTEE | GRANTED_ROLE | ADMIN_OPTION | DEFAULT_ROLE |
+---------+--------------+--------------+--------------+
| WORKATO | CONNECT      | NO           | YES          |
+---------+--------------+--------------+--------------+>

+---------+---------+------------+---------+-----------+-----------+-----------+
| GRANTEE | OWNER   | TABLE_NAME | GRANTOR | PRIVILEGE | GRANTABLE | HIERARCHY |
+---------+---------+------------+---------+-----------+-----------+-----------+
| WORKATO | HR_PROD | SUPPLIER   | ROOT    | SELECT    | NO        | NO        |
| WORKATO | HR_PROD | SUPPLIER   | ROOT    | INSERT    | NO        | NO        |
+---------+---------+------------+---------+-----------+-----------+-----------+
3 rows in set (0.61 sec)

ステップ2: OracleをWorkatoに接続する ​

OracleをWorkatoに接続するには、次の手順を実行します。

Workatoは次のOracleコネクションタイプをサポートしています：

• クラウドコネクション：Oracleデータベースがパブリックインターネット経由でアクセス可能な場合は、このオプションを使用します。
• オンプレミスエージェントコネクション：Oracleデータベースがプライベートネットワークで実行されており、接続を確立するためにオンプレミスエージェント（OPA）が必要な場合は、このオプションを使用します。

クラウドコネクション ​

Cloudコネクションを使用してに接続するには、次の手順を実行します：

オンプレミスエージェントコネクション ​

Oracleデータベースがインターネットから直接アクセスできないプライベートネットワークに配置されている場合は、オンプレミスエージェントコネクションを使用します。

オンプレミスエージェント（OPA）を使用してに接続するには、次の手順を実行します：

データベースタイプ ​

Workatoは、Oracleコネクションの作成時にコネクションタイプフィールドでオンプレミスグループを選択した場合にのみ、データベースタイプフィールドを表示します。

コネクションの設定手順については、ステップ2：OracleをWorkatoに接続するを参照してください。

オンプレミスエージェント（OPA）経由で接続する場合は、次のデータベースタイプオプションのいずれかを選択します。

サービス名 ​

サービス名を使用して、Oracleインスタンス内のデータベースサービスに接続します。 例：ORCLPDB1。

サービス名には次の特徴があります：

• Oracleリスナーに登録されているデータベースサービスにマッピングする
• Real Application Clustersおよびロードバランシングをサポートする
• 特定のインスタンスではなく論理データベースサービスを識別する

ほとんどの最新のOracleデプロイメントでは、このオプションを使用します。

SID ​

SID（System Identifier）を使用して、特定のOracleデータベースインスタンスに接続します。 例：ORCL。

SIDには次の特徴があります：

• 単一のOracleデータベースインスタンスを識別する
• ロードバランシングをサポートしない
• 古いOracleデプロイメントで一般的に使用される

DBAがサービス名ではなくSIDを提供する場合は、このオプションを使用します。

TNS ​

TNSは、完全なOracle Net接続記述子がある場合に使用します。

TNS定義には次の特徴があります：

• tnsnames.oraファイルで定義されたコネクションエントリを参照する
• 基盤となるコネクションの詳細を抽象化する
• 内部でSIDまたはサービス名を使用する場合がある
• ロードバランシングや高可用性などの高度な設定をサポートする

TNS定義フィールドに完全なTNS記述子を入力します。 例:

(DESCRIPTION=
(ADDRESS=(PROTOCOL=TCP)(HOST=db.example.com)(PORT=1521))
(CONNECT_DATA=
(SERVICE_NAME=ORCLPDB1)
)
)

パイプラインの設定 ​

Oracleをデータパイプラインソースとして設定するには、次の手順を実行します。

[minute] [hour] [day of month] [month] [day of week]

0 8 * * *

サポートされるOracleテーブル ​

Oracleコネクターは、接続済みのOracleデータベースインスタンスで使用可能なほとんどのテーブルをサポートしています。 Workatoは、パイプライン設定中に使用可能なオブジェクトを入力するために、Oracleデータベースからテーブルメタデータとスキーマ情報を取得します。

選択可能なテーブルは、次によって異なります。

• Oracleデータベースで設定されているスキーマ
• コネクションに使用されるデータベースユーザーに付与された権限