Oracle NetSuite SuiteAnalytics

SuiteAnalytics Connect を介して Foundry を Oracle NetSuite に接続し、NetSuite ERP のデータを Foundry に同期します。

サポートされている機能

機能	ステータス
探索	🟢 一般提供
バッチ同期	🟢 一般提供
インクリメンタル（差分連携）	🟢 一般提供

セットアップ

NetSuite インスタンスで SuiteAnalytics を有効にする必要があります。有効にするには、NetSuite ドキュメント ↗を参照してください。

Data Connection アプリケーションを開き、画面右上の + 新規ソースを選択します。
利用可能なコネクターの種類から JDBC を選択します。
追加の設定プロンプトに従い、以下のセクションの情報を使用してコネクターのセットアップを続けます。

Foundry でのコネクターのセットアップについて詳しくはこちら。

認証

ユーザー名/パスワードの組み合わせで SuiteAnalytics に認証できます。個人のユーザー資格情報ではなく、サービスユーザーの資格情報を使用することを推奨します。

NetSuite でユーザーのロールと権限を設定する

NetSuite では、アクセスを制御するために、各ユーザーに1つ以上のロールが割り当てられます。各ロールには、ユーザーが実行できるタスクとアクセスできるデータを定義する権限が含まれます。Foundry に接続するユーザーには、次の設定を推奨します。

適切な権限を持つ専用のロールを作成します。
1. NetSuite のツールバーから、セットアップ > ユーザー/ロール > ロールを管理 > 新規を選択し、ロールにわかりやすい名前を入力します。foundry-role を使用することを推奨します。
2. ロールのページの下部に移動し、権限 > セットアップを選択して、ロールにシステム全体の権限を追加します。SuiteAnalytics Connect を選択し、追加、保存の順に選択します。
  - 注：NetSuite ドキュメントでは、SuiteAnalytics Connect：すべて読み取り権限の追加を推奨していますが、この権限は NetSuite2.com データソースには関係ありません（詳しくはこちら ↗）。この権限を追加しても効果はありません。
3. ロールのページの下部に移動し、権限 > リストを選択して、Foundry からクエリできるようにするテーブルの権限をロールに追加します。対象のテーブルを選択し、追加、保存の順に選択します。
新しいロールをユーザーに割り当てます。
1. NetSuite のツールバーから、セットアップ > ユーザー/ロール > ユーザーの管理を選択します。Foundry への接続に使用するユーザーを選択し、編集を選択します。
2. アクセスタブに移動し、アクセスを許可チェックボックスがオンになっていることを確認してください。
3. ロールタブで、ドロップダウンリストから新しく作成したロール（foundry-role）を選択し、追加、保存の順に選択します。
  - 注：NetSuite ドキュメントでは、カスタムロールの代わりに Data Warehouse Integrator ロールを使用する方法も推奨しています。ただし、このロールではトークンベース認証によるアクセスが必要です（詳しくはこちら ↗）。この認証は Foundry では利用できません。

正しい権限が追加されたことを確認するには、新しいロールを割り当てたユーザーとしてログインし、想定しているすべてのデータを閲覧できることを確認します。

ネットワーク

SuiteAnalytics コネクターには、接続先の NetSuite Connect インスタンスへのネットワークアクセスが必要です。

Foundry ワーカー接続

接続が Foundry ワーカーで実行される場合は、ソースのセットアップ時に適切なエグレスポリシーを追加する必要があります。

許可する必要があるサービスホストとポートは、https://<YOUR_ACCOUNT_ID>.app.netsuite.com/app/external/odbc/suiteAnalyticsConnectDownload.nl にある NetSuite の設定ホームページで確認できます。 NetSuite アカウントIDを使用せずにこのページにアクセスするには、次の手順を実行します。

NetSuite アカウントのホームページにログインします。
左下の設定パネルを見つけ、SuiteAnalytics Connect をセットアップを選択します。

サービスホストは通常 <ACCOUNT_ID>.connect.api.netsuite.com の形式で、ポートは 1708 です。

このようなエグレスポリシーが存在しない場合は、新しいポリシーを申請できます。存在する場合は、そのポリシーを追加できます。

HTTPS 以外のプロトコルを使用するため、次の両方を追加する必要があります。

サービスホストを名前で参照する DNS ポリシー
IP 範囲を明示的に参照する CIDR ポリシー。ターミナルで nslookup you-service-host を実行すると、NetSuite インスタンスの IP 範囲を取得できます。NetSuite サービスの IP アドレスは、予告なくいつでも変更される可能性があります。

接続情報

オプション	必須	説明
`URL`	はい	`jdbc:ns://<SERVICE_HOST>:<SERVICE_PORT>` の形式です。`SERVICE_HOST` と `SERVICE_PORT` は、NetSuite の設定ホームページで確認できます。通常は `jdbc:ns://<ACCOUNT_ID>.connect.api.netsuite.com:1708` の形式です。
ドライバークラス	はい	com.netsuite.jdbc.openaccess.OpenAccessDriver にする必要があります。
ドライバー	はい	Foundry ワーカーの場合は、NetSuite の設定ホームページから最新の JDBC ドライバーをアップロードします。Agent ワーカー [レガシー] 接続の場合は、同じ JDBC ドライバーを Agent にアップロードする前に適切に署名する必要があります。Palantir サポートにお問い合わせください。詳細は、Agent にドライバーを追加する方法を参照してください。
資格情報	はい	Foundry への接続に使用するユーザーのユーザー名とパスワードです。
JDBC プロパティ	はい	利用可能なプロパティの全リストは、こちら ↗で説明されています。次のプロパティは必須です。 - CustomProperties : `(AccountID=<ACCOUNT_ID>;RoleID=<ROLE_ID>)` ROLE_ID は、ユーザーに割り当てたロール（`foundry-role`）に関連付けられている内部IDです。この値は、セットアップ > ユーザー/ロール > ロールを管理ページでロール名の横に表示されます。内部IDが表示されない場合は、表示を有効にする方法 ↗を参照してください。 - NegotiateSSLClose : `false` - ServerDataSource : `NetSuite2.com` 2021年11月8日以降、新しい Connect ユーザーは NetSuite2.com データソースを使用する場合にのみ Connect Service にアクセスできます。詳細は、Oracle NetSuite のドキュメント ↗を参照してください。 - encrypted : `1`

その他の接続パラメーターは、他の JDBC ソースと同じです。

同期を作成する

NetSuite SuiteAnalytics ソースを探索して、テーブルを見つけ、新しい同期を作成できます。ソースの概要ページから、新しい同期を手動で作成することもできます。

←

PREVIOUS概要

NEXTNetSuite SuiteQL (JDBC)

→