入力ストリームは使われません。ストリームフォーマットは選択不可です。

任意のSQLを実行 [SQL]

SELECT以外の任意のSQLを実行する場合に使用します。

SELECT文を発行 [SQL-Record]

SELECT文を実行する場合に使用します。

ストアド実行(結果なし) [Procedure]

結果セットを返さないストアドプロシージャを実行する場合に使用します。

ストアド実行(結果あり) [ProcedureRecord]

結果セットを返すストアドプロシージャを実行する場合に使用します。

このフィールドは、User およびPassword とともに、NetSuite に対する認証に使用されます。

集計カラムは、子コレクション内に含まれるすべてのデータを集計する基本テーブルに表示されるカラムです。 これらのカラムには子コレクションのすべてのデータが含まれているため、非常に大きくなる可能性があります。 オフラインデータベースへのデータの書き込みなど、状況によってはAggregateColumnMode をIgnore またはList に設定することをお勧めします。 子テーブル内のデータは、IncludeChildTables をtrue に設定することで取得できます。 AggregateColumnMode をList に設定した場合でも、挿入および更新で使用するための集計カラムはリストされます。

NetSuite UI の［セットアップ］->［統合］->［統合の管理］で、アプリケーションを見つけることができます。 NetSuite との接続を確立する際に、利用可能な最大セッション数を確保するために、常に独自のアプリケーションを作成することをお勧めします。

このプロパティは、OAuth 1.0でヘッドレス認証を実行する場合にのみ必要です。これは、GetOAuthAuthorizationUrl ストアドプロシージャから取得できます。

GetOAuthAccessToken ストアドプロシージャでAuthToken とともに指定して、OAuthAccessToken を取得できます。

• Auto:設定したOther 接続プロパティに基づいてドライバーが自動的に決定。
• Basic:BASIC ユーザー / パスワード認証を使用する場合に設定。
• OAuth:OAuth 認証を実行する場合に設定。これは基本的にトークンベース認証であり、NetSuite UI で直接ではなく、その場でトークンが作成されます。
• Token:トークンベースの認証を実行する場合に設定。

このプロパティは、OAuth 1.0でヘッドレス認証を実行する場合にのみ必要です。これは、GetOAuthAuthorizationUrl ストアドプロシージャから取得できます。

GetOAuthAccessToken ストアドプロシージャでAuthKey とともに指定して、OAuthAccessToken を取得できます。

AutoCache がtrue に設定されていると、本製品 はテーブルデータのキャッシュを選択したデータベースに自動的に保存します。デフォルトでは、本製品 はキャッシュをインクリメンタル更新します。前回の実行からの時間がCacheTolerance を超えた場合は、最後のSELECT クエリが実行された後の変更のみを取得します。キャッシュが更新された後、キャッシュデータに対してクエリが実行されます。

キャッシュデータベースの設定

AutoCache がtrue の場合、本製品 はシンプルなファイルベースストアにキャッシュします。次のプロパティを使って、場所またはキャッシュを別のデータベースに構成できます。

• CacheLocation：ファイルストアへのパスを指定します。
• CacheDriver およびCacheConnection：ドライバーをデータベースと接続文字列に指定します。

関連項目

• CacheTolerance：このプロパティはキャッシュ内の失効データに対する許容範囲を制御します。
• CacheMetadata：このプロパティは、NetSuite メタデータから取得したテーブルスキーマを永続化することによって、ネットワークを横断するメタデータの量を減らします。メタデータは、すべての接続で取得する必要はなく、一度取得するだけです。
• REPLICATE ステートメント：AutoCache をtrue にしてSELECT ステートメントを実行すると、本製品 は内部的にREPLICATE ステートメントを呼び出します。REPLICATE ステートメントは、最初にキャッシュされたテーブルを削除するのではなく、インクリメンタル更新を有効にします。
• 明示的なデータのキャッシュ：このセクションでは、AutoCache をOffline で使用する例をさらに示します。
• CACHE ステートメント：CACHE ステートメントを使って、SELECT クエリを永続化し、キャッシュを管理（例えば、スキーマのリフレッシュ）ができます。

スキーマをデータベースからリストすると、負荷がかかる可能性があります。接続文字列でスキーマのリストを提供すると、 パフォーマンスが向上します。

キャッシュデータベースは、CacheDriver およびCacheConnection プロパティに基づいて決定されます。キャッシュデータベースを使用するには、両方のプロパティが必須です。以下に、一般的なキャッシュデータベースの設定例を示します。キャッシュデータベースのドライバーの設定方法についての詳細は、CacheDriver を参照してください。

CacheConnection プロパティで指定された接続文字列は、基底のCacheDriver に直接渡されます。使用可能なプロパティについての詳細は、JDBC driver 固有のドキュメントを参照してください。アプリケーションのクラスパスにJDBC driver を含めてください。

Derby およびJava DB

本製品 はDerby へのキャッシュを簡略化します。CacheLocation プロパティを設定するだけで基本的な接続を確立できます。

あるいは、CacheDriver とCacheConnection を使用してDerby への接続を手動で設定することもできます。次はDerby JDBC URL シンタックスです。

jdbc:derby:[subsubprotocol:][databaseName][;attribute=value[;attribute=value] ... ]

jdbc:derby:memory

SQLite

SQLite へキャッシュするにはSQLite JDBC ドライバーを使用できます。次はJDBC URL の構文です。

jdbc:sqlite:dataSource

• Data Source：SQLite データベースファイルへのパス。または、:memoryの値を使ってインメモリにキャッシュします。

MySQL

インストールにはCData JDBC Driver for MySQL が含まれています。次にJDBC URL の例を示します。

jdbc:mysql:User=root;Password=root;Server=localhost;Port=3306;Database=cache

• Server：接続しようとするサーバーのIP アドレス、もしくはドメイン名。
• Port：サーバーが起動しているポート名。
• User：データベースへの認証のためのユーザー名。
• Password：データベースへの認証のためのパスワード。
• Database：データベース名。

SQL Server

Microsoft JDBC Driver for SQL Server のJDBC URL の構文は次のとおりです。

jdbc:sqlserver://[serverName[\instance][:port]][;database=databaseName][;property=value[;property=value] ... ]

jdbc:sqlserver://localhost\sqlexpress:1433;integratedSecurity=true

• Server：SQL Server を起動しているコンピューターのネットワークアドレス名。デフォルトインスタンスの代わりに名前付きインスタンスに接続する場合は、このプロパティを使ってホスト名およびインスタンスをバックスラッシュで区切って指定できます。
• Port：SQL Server が起動しているポート。
• Database：SQL Server データベース名。
• Integrated Security：現在のWindows アカウントを認証に使用する場合は、このオプションをtrue に設定します。接続でUser とPassword を設定する場合は、このオプションをfalse に設定します。

  統合セキュリティを使用するには、Windows システムパス上のフォルダにsqljdbc_auth.dll も追加する必要があります。このファイルは、Microsoft JDBC Driver for SQL Server インストールのauth サブフォルダにあります。アセンブリのビット数はJVM のビット数と一致する必要があります。

• User Id：SQL Server との認証に使われるユーザー名。このプロパティは、統合セキュリティを使用していない場合にのみ必要です。
• Password：SQL Server との認証に使われるパスワード。このプロパティは、統合セキュリティを使用していない場合にのみ必要です。

Oracle

次はOracle JDBC Thin ドライバーの従来のJDBC URL シンタックスです。

jdbc:oracle:thin:[userId/password]@[//]host[[:port][:sid]]

jdbc:oracle:thin:scott/tiger@myhost:1521:orcl

• Data Source：Oracle データベースを識別する接続記述子。これは、TSN 接続記述子、接続記述子を決定するOracle Net Services 名、またはバージョン11g以降ではEasy Connect ネーミング（任意のポート名およびサービス名を持つOracle サーバーのホスト名）になります。

• Password：Oracle データベースへの認証のためのパスワード。
• User Id：Oracle データベースへの認証のためのユーザーId。

PostgreSQL

次は公式のPostgreSQL JDBC ドライバーのJDBC URL 構文です。

jdbc:postgresql:[//[host[:port]]/]database[[?option=value][[&option=value][&option=value] ... ]]

jdbc:postgresql:postgres

• Host：PostgreSQL データベースをホストしているサーバーのアドレス。
• Port：PostgreSQL データベースをホスティングしているサーバーに接続する際のポート。
• Database：データベース名。
• User name：PostgreSQL データベースの認証用に提供されたユーザーId。"user" パラメータを使ってJDBC URL に指定できます。
• Password：PostgreSQL データベースへの認証のためのパスワード。

CData JDBC drivers を含むJDBC ドライバーが用意されている任意のデータベースにキャッシュできます。

キャッシュデータベースは、CacheDriver およびCacheConnection プロパティに基づいて決定されます。CacheDriver は、データのキャッシュに使用するJDBC ドライバークラスの名前です。

CacheDriver JAR ファイルをクラスパスに追加する必要があります。

次の例は、いくつかの主要なデータベースにキャッシュする方法を示しています。JDBC URL 構文および一般的な接続プロパティの詳細については、CacheConnection を参照してください。

Derby およびJava DB

本製品 はDerby 設定を簡略化します。Java DB は、Derby のOracle ディストリビューションです。JAR ファイルはJDK に同梱されています。JAR ファイル、derby.jar は、JDK インストールフォルダのdb サブフォルダに格納されています。ほどんどのキャッシュシナリオでは、derby.jar をクラスパスに追加した後、次のものだけを指定する必要があります。

jdbc:netsuite:CacheLocation='c:/Temp/cachedir';Account Id=XABC123456;Password=password;User=user;Role Id=12345;

jdbc:netsuite:CacheDriver=org.apache.derby.jdbc.EmbeddedDriver;CacheConnection='jdbc:derby:memory';Account Id=XABC123456;Password=password;User=user;Role Id=12345;

SQLite

次はSQLite JDBC ドライバーのJDBC URL です。

jdbc:netsuite:CacheDriver=org.sqlite.JDBC;CacheConnection='jdbc:sqlite:C:/Temp/sqlite.db';Account Id=XABC123456;Password=password;User=user;Role Id=12345;

MySQL

次はCData JDBC Driver for MySQL のJDBC URL です。

  jdbc:netsuite:Cache Driver=cdata.jdbc.mysql.MySQLDriver;Cache Connection='jdbc:mysql:Server=localhost;Port=3306;Database=cache;User=root;Password=123456';Account Id=XABC123456;Password=password;User=user;Role Id=12345;
  

SQL Server

次のJDBC URL はMicrosoft JDBC Driver for SQL Server を使用しています。

jdbc:netsuite:Cache Driver=com.microsoft.sqlserver.jdbc.SQLServerDriver;Cache Connection='jdbc:sqlserver://localhost\sqlexpress:7437;user=sa;password=123456;databaseName=Cache';Account Id=XABC123456;Password=password;User=user;Role Id=12345;

Oracle

次はOracle Thin Client のJDBC URL です。

jdbc:netsuite:Cache Driver=oracle.jdbc.OracleDriver;CacheConnection='jdbc:oracle:thin:scott/tiger@localhost:1521:orcldb';Account Id=XABC123456;Password=password;User=user;Role Id=12345;

PostgreSQL

次のJDBC URL は公式のPostgreSQL JDBC ドライバーを使用しています。

jdbc:netsuite:CacheDriver=cdata.jdbc.postgresql.PostgreSQLDriver;CacheConnection='jdbc:postgresql:User=postgres;Password=admin;Database=postgres;Server=localhost;Port=5432;';Account Id=XABC123456;Password=password;User=user;Role Id=12345;

CacheLocation は単純なファイルベースキャッシュです。本製品 はJava DB、Oracle のDerby データベースのディストリビューションを使用しています。Java DB にキャッシュするには、Java DB JAR ファイルをクラスパスに追加する必要があります。JAR ファイル、derby.jar はJDK に同梱され、JDK インストールの［db］サブフォルダに配置されています。

指定しない場合、デフォルトの場所は"%APPDATA%\\CData\\NetSuite Data Provider" となり、%APPDATA%はユーザーのコンフィギュレーションディレクトリに設定されます：

関連項目

• AutoCache：後のオフライン使用のために、暗黙的にキャッシュを作成して維持するように設定します。
• CacheMetadata：NetSuite カタログをCacheLocation に永続化するように設定します。

このプロパティを設定してクエリを実行すると、NetSuite カタログのテーブルメタデータが設定されている場合にはCacheLocation で指定されたファイルストアに、設定されていない場合にはホームディレクトリにキャッシュされます。テーブルのメタデータの取得は、テーブルがはじめてクエリされた際に一度だけ行われます。

CacheMetadata を使用するタイミング

本製品 は、はじめてテーブルやビューを発見したときから2時間の間、メタデータをインメモリに自動的に保管します。そのため、CacheMetadata は一般的には必要ありません。CacheMetadata は、大量のメタデータを扱う場合でメタデータオペレーションのコストが高い場合や、短い接続を大量に行う場合などに役立ちます。

CacheMetadata を使用しないタイミング

• 変化しやすいメタデータを扱う場合：テーブルのメタデータは、はじめにテーブルへの接続がなされた時に一度しか取得されません。それ以降の、新規、変更、削除されたカラムを取得するには、メタデータキャッシュを削除してリビルドする必要があります。よって、メタデータが頻繁に変更される場合には、インメモリキャッシュを使う方が便利です。
• データベースにキャッシュする場合：CacheMetadata はCacheLocation でのみ使用可能です。CacheDriver およびCacheConnection プロパティで他のデータベースへのキャッシュが可能です。黙示的なキャッシュにはAutoCache を使ってください。もしくは、REPLICATE ステートメント または CACHE ステートメント で明示的なキャッシュが可能です。

キャッシュ内の失効データに対する許容範囲の秒数。これは、AutoCache が使用されている場合のみ有効です。本製品 は、許容インターバルが過ぎると、新しいレコードがないかデータソースをチェックしに行きます。それ以外は、キャッシュから直接データを返します。

認証プロセス中、OAuth 認証サーバーはユーザーをこのURL にリダイレクトします。この値をアプリケーションに指定したコールバックURL と同じ値に設定します。

接続の最大有効期間（秒単位）。その時間が経過すると、接続オブジェクトは削除されます。デフォルトは0で、接続の有効期間に制限がないことを示します。

true に設定すると、接続が開かれたときにNetSuite への接続が作成されます。このプロパティは、さまざまなデータベースツールで［接続のテスト］機能を利用できるようにします。

この機能はNOOP コマンドとして作用します。NetSuite に接続できることを確認するために使用され、この初期接続からは何も維持されません。

このプロパティをfalse に設定すると、パフォーマンスが向上する場合があります（接続が開かれる回数に依存します）。

このプロパティはIncludeCustomFieldColumns に加えて、またはその代わりに設定できます。あるカスタムフィールドは許可して別のものは許可しない、というように認証にロールを使用したい場合は、このプロパティを使ってどのカスタムフィールドのメタデータがCData JDBC Driver for NetSuite 2021J からリクエストされるのか、指定することができます。 このプロパティが空のままの場合、IncludeCustomFieldColumns が、すべてのカスタムフィールドのメタデータがリクエストされているのか、カスタムフィールドのメタデータは全くリクエストされていないのかを決定します。 空でなければ、このプロパティはIncludeCustomFieldColumns の動作をオーバーライドします。

例えば、すべてのカスタムフィールドの許可をすべての利用可能なテーブルに指定するには、このプロパティを以下のように設定します。

Custom Body Fields, Custom Column Fields, Custom Entity Fields, Custom Event Fields, Custom Item Fields, Item Number Fields, Other Custom Fields

このプロパティは、FirewallType により指定された認証メソッドに則り、FirewallServer およびFirewallPort で指定されたプロキシに渡されます。

ファイアウォールトラバーサルを許容するために設定するプロキシベースのファイアウォールのTCP ポート。名前もしくはIP アドレスを指定するには、FirewallServer を使います。FirewallType でプロトコルを指定します。

ファイアウォールトラバーサルを許容するために設定するIP アドレス、DNS 名、もしくはプロキシホスト名を指定するプロパティです。プロトコルはFirewallType で指定されます。このプロパティとFirewallServer を使って、SOCKS 経由での接続、もしくはトンネリングが可能です。HTTP プロキシへの接続には、ProxyServer を使用します。

本製品 はデフォルトでシステムプロキシを使うので注意してください。他のプロキシを使う場合には、ProxyAutoDetect をfalse に設定してください。

このプロパティは、本製品 がFirewallServer プロキシ経由でトンネルトラフィックを使うためのプロトコルを指定します。デフォルトでは、本製品 はシステムプロキシに接続します。この動作を無効化し次のプロキシタイプのどれかで接続するには、ProxyAutoDetect をfalse に設定します。

HTTP プロキシへの接続には、ProxyServer およびProxyPort ポートを使ってください。HTTP プロキシへの認証には、ProxyAuthScheme、ProxyUser、およびProxyPassword を使ってください。

FirewallUser およびFirewallPassword プロパティは、FirewallType により指定された認証方式に則り、FirewallServer、およびFirewallPort で指定されたプロキシに対しての認証に使われます。

これをtrue に設定すると、指定したエンティティのすべての子リストに対してテーブルが表示されます。 例えば、NetSuite 開発環境のCashRefund テーブルにはItemList という子リストがあります。したがって、このプロパティがtrue に設定されている場合、CashRefund_ItemList という新しいテーブルが表示されます。 これは、リスト内の各アイテムをそれ自体の行にリストするのに便利です。

これをtrue に設定すると、カスタムフィールドが独自のカラムとして直接テーブルに表示されます。ただし、オープン接続で初めてテーブルのメタデータ情報を取得する場合、パフォーマンスは低下します。 テーブルのメタデータは接続時に格納され、接続が閉じられるとクリアされます。

これをtrue に設定すると、カスタムリストタイプが独自のテーブルとして含まれます。ただし、オープン接続で初めてテーブルのメタデータ情報を取得する場合、パフォーマンスは低下します。 テーブルのメタデータは接続時に格納され、接続が閉じられるとクリアされます。

これをtrue に設定すると、カスタムレコードタイプが独自のテーブルとして含まれます。ただし、オープン接続で初めてテーブルのメタデータ情報を取得する場合、パフォーマンスは低下します。 テーブルのメタデータは接続時に格納され、接続が閉じられるとクリアされます。

NetSuite の多くのフィールドは、他のタイプのレコードへの参照です。例えば、Invoice はAccount およびCustomer レコードを参照します。 レコード参照フィールドからデータを取得するときに、NetSuite から返されるデータがいくつかあります。 利用可能な値は次のとおりです。

次のオプションが利用可能です。

1. OFF：OAuth フローが完全にユーザーにより操作されることを示します。認証にはOAuth アクセストークンが必要です。
2. GETANDREFRESH：OAuth フローが完全に本製品 により操作されることを示します。現在トークンが存在しない場合にはブラウザを通じてユーザーをプロンプトすることで取得されます。トークンが存在する場合には必要に応じてリフレッシュされます。
3. REFRESH：本製品 がOAuthAccessToken のリフレッシュのみを操作することを示します。ユーザーは本製品 によりブラウザを通じて認証することをプロンプトされることはありません。OAuthAccessToken とOAuthRefreshToken の最初の取得はユーザーが行う必要があります。

本製品 のスキーマファイル（テーブルとビューの場合は.rsd ファイル、ストアドプロシージャの場合は.rsb ファイル）を含むディレクトリへのパス。このフォルダの場所は、実行ファイルの場所からの相対パスにすることができます。Location プロパティは、定義をカスタマイズしたり（例えば、カラム名を変更する、カラムを無視するなど）、新しいテーブル、ビュー、またはストアドプロシージャでデータモデルを拡張する場合にのみ必要です。

Note： この本製品 は複数のスキーマをサポートするため、NetSuite カスタムスキーマファイルの構造は以下のようになります。

• 各スキーマには、そのスキーマ名に対応するフォルダが作られます。
• これらのスキーマフォルダは親フォルダに含まれています。
• 親フォルダは、個々のスキーマのフォルダではなく、Location として設定する必要があります。

指定しない場合、デフォルトの場所は"%APPDATA%\\CData\\NetSuite Data Provider\\Schema" となり、%APPDATA% はユーザーのコンフィギュレーションディレクトリに設定されます：

このプロパティを設定すると、認証が実行されたときやクエリが実行されたときなど、さまざまなタスクを実行する際に、本製品 がログファイルを生成します。指定したファイルが存在しない場合は作成されます。

接続文字列およびバージョン情報も記録されますが、機密情報を含む接続プロパティは自動的にマスクされます。

相対ファイルパスが指定された場合、ログファイルの場所は、Location 接続プロパティにあるパスに基づいて解決されます。

ログファイルに記録される内容をより細かく制御するには、Verbosity プロパティを調整してください。

ログ内容はいくつかのモジュールに分類されます。LogModules プロパティを使うことで、個々のモジュールを表示または非表示にすることができます。

新しいログファイルの作成前にログファイル1つの最大サイズを変更する方法については、MaxLogFileSize を参照してください。

生成されるログファイル数に上限を設定したい場合は、MaxLogFileCount を使用してください。

Java のログ出力

Java のログ出力もサポートされています。Java のログ出力を有効化するには、Logfile を次のように設定します：

Logfile=JAVALOG://myloggername

上記の例のように、JAVALOG:// がJava のログを使用するための必須プレフィックスで、独自のロガーで代用することになります。

次に、指定されたロガーのgetLogger メソッドが呼び出され、指定された値を使用してLogger インスタンスが作成されます。ログのインスタンスがすでに存在する場合は、既存のインスタンスを参照します。

Java のログ出力が有効になっている場合、Verbosity は特定のログレベルに対応します。

指定された（';' で区切られた）モジュールのみがログファイルに含まれます。デフォルトではすべてのモジュールが含まれます。

概要はログ ページを参照してください。

バージョン2020.1 では、この値はAccountId およびApplicationId に基づいて自動的に取得されます。 NetSuite 2020.1 時点での同時接続セッションは、トークンベース認証でのみ可能です。 ユーザー/パスワードは常に利用可能な単一のセッションのみを解決します。

NetSuite では、一般的に最大5つの同時接続セッションを許可していますが、それ以上のレベルを購入することもできます。 接続に使用されているアカウントまたは統合アプリの同時セッション制限を超える追加のリクエストを行うと、エラーが発生します。 CData JDBC Driver for NetSuite 2021J はすでに多くの同時リクエストが行われている場合、エラーを受け取る追加リクエストを保留することで、これを自動的に考慮しようとします。

アカウントの利用可能額が多い場合、同時利用可能なセッションの最大数を設定することができます。

サイズリミットを超えると、日付と時刻が末尾に追加された新しいログが同じフォルダ内に作成され、最も古いログファイルが削除されます。

サポートされている最小値は2です。0や負の値は、数に制限がないことを示します。

生成されるログファイルの最大サイズは、MaxLogFileSize で調整できます。

サイズリミットを超えると、日付と時刻が末尾に追加された新しいログが同じフォルダ内に作成されます。リミットのデフォルトは100 MB です。100 kB より小さい値を設定した場合、100 kB がリミットとなります。

生成されるログファイルの最大数は、MaxLogFileCount で調整できます。

クエリで集計またはグループ化を使用しない場合に返される行数を制限します。これにより、設計時にパフォーマンスの問題を回避できます。

The preffered date format set in NetSuite UI. This format should be used when filtering based on Date. You can change the date format in NetSuite UI using Home -> Set Preferences -> Formatting.

Available values are: 'M/D/YYYY', 'D/M/YYYY', 'D.M.YYYY', 'D-MONTH-YYYY', 'D MONTH, YYYY', 'YYYY/M/D', 'YYYY-M-D', 'DD/MM/YYYY', 'DD-MON-YYYY', 'DD.MM.YYYY', 'DD-MONTH-YYYY', 'DD MONTH, YYYY', 'MM/DD/YYYY', 'YYYY/MM/DD', 'YYYY-MM-DD'.

Note:This property is only applicable for SuiteQL Schema. If the two formats are mismatched, the server thows an exception.

The preffered long date format set in NetSuite UI. This format should be used when filtering based on long date. You can change the long date format in NetSuite UI using Home -> Set Preferences -> Formatting

Available values are: 'Month D, YYYY', 'D Month YYYY', 'YYYY Month D', 'Month DD, YYYY', 'DD Month YYYY', 'YYYY Month DD'.

Note:This property is only applicable for SuiteQL Schema. If the two formats are mismatched, the server thows an exception.

不必要なオーバーヘッドを避けるために、本製品 はNetSuite API から多くのメタデータファイルをダウンロードします。 NetsuiteMetadataFolder が指定されていない場合は、Location が使用されます。最高のパフォーマンスを 得るには、常にNetSuiteMetadata の値を設定します。このディレクトリが空の場合、本製品 はNetsuite から スキーマファイルをダウンロードし、それらを後続のメタデータクエリに使用します。これらのメタデータファイルのファイル 拡張子はxsd です。このメタデータには、Netsuite Version 固有の静的に定義されたテーブルとビューのみが 含まれています。カスタムフィールドとテーブルは、このメタデータには含まれません。 本製品 は、接続するNetsuite のバージョンごとに異なるサブフォルダを作成します。

OAuth を使用して接続するには、OAuthAccessToken プロパティが使用されます。認証プロセスにおいてOAuth サーバーからOAuthAccessToken が取得されます。このプロパティは、サーバーに依存するタイムアウトがあり、要求の間で再利用することができます。

アクセストークンは、ユーザー名とパスワードの代わりに使用されます。サーバー上で維持することで、認証情報が保護されます。

OAuth を使用して接続および認証するには、OAuthAccessTokenSecret プロパティが使用されます。認証プロセスにおいてOAuth サーバーからOAuthAccessTokenSecret が取得されます。取得されたトークンシークレットは OAuthAccessToken と一緒に使用され、タイムアウトするまで複数の要求のために使用されます。

OAuth アプリケーションの登録の一環として、コンシューマキーとも呼ばれるOAuthClientId 値、およびクライアントシークレットOAuthClientSecret が提供されます。

OAuth アプリケーションの登録の一環として、コンシューマキーとも呼ばれるOAuthClientId が提供されます。また、コンシューマーシークレットと呼ばれるクライアントシークレットも提供されます。クライアントシークレットをOAuthClientSecret プロパティに設定します。

OAuthTokenTimestamp と併用して、アクセストークンの有効期限を決定します。

OAuthRefreshToken プロパティは、OAuth 認証時にOAuthAccessToken のリフレッシュに使われます。

InitiateOAuth がGETANDREFRESH またはREFRESH に設定されている場合、本製品 がOAuth 値を保存するため、ユーザーが手動でOAuth 接続プロパティを入力する必要がなくなり、接続やプロセス間でクレデンシャルを共有できるようになります。

ファイルパスを指定する代わりに、メモリストレージを使用することもできます。メモリの場所は、'memory://' で始まる値とそのクレデンシャルのセット（例：memory://user1）の一意の識別子を使用して指定します。識別子は何でも構いませんが、ユーザーに固有のものでなければなりません。ファイルベースのストレージとは異なり、プロセスが再開されたときに接続を設定できるように、メモリストレージとの接続を閉じるときは手動でクレデンシャルを格納する必要があります。OAuth プロパティ値は、sys_connection_props システムテーブルへのクエリで取得できます。複数の接続で同じクレデンシャルを使用している場合は、プロパティは最後に閉じられる接続から読み取られます。

指定しない場合、デフォルトの場所は"%APPDATA%\\CData\\NetSuite Data Provider\\OAuthSettings.txt" となり、%APPDATA%はユーザーのコンフィギュレーションディレクトリに設定されます：

OAuthExpiresIn と併用して、アクセストークンの有効期限を決定します。

OAuth 認可URL から返された検証コード。これは、ヘッドレスシステムのようにブラウザを起動できないシステム上で使用できます。

ヘッドレスマシンでの認証

OAuthVerifier 値を取得するには、 を参照してください。

OAuthVerifier に加えてOAuthSettingsLocation を設定します。接続すると、本製品 はOAuth 認証トークンのOAuthVerifier を交換し、暗号化して、指定されたファイルに保存します。 交換を自動化するには、InitiateOAuth をGETANDREFRESH に設定します。

OAuth 設定ファイルが生成されたら、接続プロパティからOAuthVerifier を削除して OAuthSettingsLocation セットで接続できます。

OAuth トークン値を自動的にリフレッシュするには、 OAuthSettingsLocation を設定し、さらにInitiateOAuth をREFRESH に設定します。

使われているOAuth のバージョン。次のオプションが利用可能です：1.0,2.0

Offline がtrue に設定されている場合、すべてのクエリは、ライブデータソースではなくキャッシュに対して実行されます。このモードでは、INSERT、UPDATE、DELETE、CACHE などのクエリは許可されません。

以下にリストされているプロパティは、特定のユースケースで使用可能です。通常のドライバーのユースケースおよび機能では、これらのプロパティは必要ありません。

複数のプロパティをセミコロン区切りリストで指定します。

キャッシュの設定

統合およびフォーマット

ページサイズは、NetSuite からリクエストされたクエリの結果数をコントロールできます。 より大きなページサイズを設定することにより、一定のリクエストで返せるデータ量を増やすことができますが、実行にはより長い時間がかかります。 タイムアウト例外を発生させないためには、より小さなページサイズを設定することが推奨されます。

このフィールドは、User およびAccountId とともに、NetSuite に対する認証に使用されます。

接続が閉じられるまで、プール内に残ることができる許容されたアイドル時間。デフォルトは60秒です。

プールの最大接続数。デフォルトは100です。このプロパティを無効にするには、プロパティ値を0以下に設定します。

プール内の最小接続数。デフォルトは1です。

接続が利用可能になるまで待機する最大秒数。新しい接続のリクエストが使用可能な接続を待ちこの時間を超過すると、エラーが返されます。デフォルトでは、新規リクエストは使用可能な接続を永久に待機します。

この値は、ProxyServer およびProxyPort で指定されるHTTP プロキシに認証するために使われる認証タイプを指定します。

本製品 は、デフォルトでsystem proxy settings を使い、追加での設定が不要です。他のプロキシへの接続をする場合には、ProxyServer およびProxyPort に加え、ProxyAutoDetect をfalse に設定します。認証するには、ProxyAuthScheme を設定し、必要な場合にはProxyUser およびProxyPassword を設定します。

認証タイプは、次のどれかになります。

• BASIC： 本製品 はHTTP BASIC 認証を行います。
• DIGEST： 本製品 はHTTP DIGEST 認証を行います。
• NEGOTIATE： 本製品 は認証において有効なプロトコルに応じて、NTLM もしくはKereros トークンを取得します。
• PROPRIETARY： 本製品 はNTLM もしくはKerberos トークンを発行しません。このトークンを、HTTP リクエストのAuthorization ヘッダーに含める必要があります。

SOCKS 5 認証のような他の認証タイプを使用するには、FirewallType を参照してください。

これは他のプロキシ設定よりも優先されるため、カスタムプロキシ設定を使用するにはProxyAutoDetect をFALSE に設定する必要があります。

NOTE:このプロパティがTrue に設定されている場合、使用されるプロキシは次のように決定されます。

• JVM のプロパティ（http.proxy、https.proxy、socksProxy など）から検索が実行されます。
• JVM のプロパティが存在しない場合は、java.home/lib/net.properties から検索が実行されます。
• java.net.useSystemProxies がTrue に設定されている場合は、SystemProxy から検索が実行されます。
• Windows の場合のみ、レジストリのインターネットオプションからこれらのプロパティを取得しようとします。

HTTP プロキシへの接続には、ProxyServer を参照してください。SOCKS やトンネリングなどの他のプロキシには、FirewallType を参照してください。

ProxyServer は、このプロパティで定義されたアドレスを除くすべてのアドレスに使用されます。セミコロンを使用してエントリを区切ります。

本製品 は、追加設定なしにデフォルトでシステムのプロキシ設定を使います。この接続のプロキシ例外を明示的に構成するには、ProxyAutoDetect をfalse に設定して、ProxyServer およびProxyPort を設定する必要があります。認証するには、ProxyAuthScheme を設定し、必要な場合にはProxyUser およびProxyPassword を設定します。

このプロパティは、NTLM(Windows)、Kerberos、もしくはHTTP 認証をサポートするHTTP プロキシサーバーに認証するために使われます。HTTP プロキシを指定するためには、ProxyServer およびProxyPort を設定します。認証タイプを指定するためにはProxyAuthScheme を設定します。

HTTP 認証を使う場合、さらにHTTP プロキシにProxyUser およびProxyPassword を設定します。

NTLM 認証を使う場合、Windows パスワードにProxyUser およびProxyPassword を設定します。Kerberos 認証には、これらを入力する必要があります。

SOCKS 5 認証もしくは、トンネリングは、FirewallType を参照してください。

デフォルトで、本製品 はsystem プロキシを使います。他のプロキシに接続する場合には、これをfalse に設定します。

HTTP トラフィックをリダイレクトするHTTP プロキシが実行されているポート。ProxyServer でHTTP プロキシを指定します。その他のプロキシタイプについては、FirewallType を参照してください。

HTTP トラフィックをルートするためのプロキシのホストネームもしくはIP アドレス。HTTP プロキシへの認証には、本製品 はHTTP、Windows(NTLM)、もしくはKerberos 認証タイプを使用することができます。

SOCKS プロキシを経由して接続する、もしくは接続をトンネルするには、FirewallType を参照してください。

デフォルトで、本製品 はsystem プロキシを使います。他のプロキシを使う場合には、ProxyAutoDetect をfalse に設定します。

このプロパティは、ProxyServer で指定されたHTTP プロキシへの接続にSSL を使用するかどうかを決定します。この値は、AUTO、ALWAYS、NEVER、TUNNEL のいずれかです。有効な値は次のとおりです。

ProxyUser および ProxyPassword オプションは、ProxyServer で指定されたHTTP プロキシに対して接続および認証するために使用されます。

ProxyAuthScheme で使用可能な認証タイプを選択することができます。HTTP 認証を使う場合、これをHTTP プロキシで識別可能なユーザーのユーザー名に設定します。Windows もしくはKerberos 認証を使用する場合、このプロパティを次の形式のどれかでユーザー名に設定します。

user@domain
domain\user

Entity Framework ではテーブルカラムでない疑似カラムに値を設定できないため、この設定はEntity Framework で特に便利です。この接続設定の値は、"Table1=Column1, Table1=Column2, Table2=Column3" の形式です。"*=*" のように"*" 文字を使用して、すべてのテーブルとすべてのカラムを含めることができます。

このプロパティがtrue に設定されている場合、本製品 はSELECT クエリのみ許可します。INSERT、UPDATE、DELETE、およびストアドプロシージャクエリではエラーが返されます。

NetSuite API 内では、すべてのカラムがdouble としてレポートされます。ただし、この設定は集計クエリ内で使われると丸め処理に問題が発生する可能性があります。 金額に関するカラムが使用される場合、通常はdecimal としてレポート、格納されることが想定されています。 NetSuite API がこれらのカラムを扱う方法は変更できませんが、ツール内でdecimal として表現することで、集計のような式内で使用する際に、上の問題を回避できます。 既存の実装との後方互換性を保つには、このプロパティをfalse に設定してください。

NetSuite で記憶されたトランザクションは、後から再び使用する可能性があるために記憶されたトランザクションです。 定期的に繰り返すように設定することも、ユーザーへのリマインダーにすることもできます。

このフィールドは、User、Password、およびAccountId とともに、NetSuite に対する認証に使用されます。 RoleId を指定しない場合は、ユーザーのデフォルトロールが使用されます。それ以外の場合は、NetSuite にログインして［セットアップ］->［統合］->［Web サービスのプリファレンス］ページに移動してRoleId を取得することができます。ここでは、指定されたロールの横に表示されているId を取得するのと同様に、別の［Web サービスデフォルトロール］を選択できます。

This property applies only to the SuiteQL schema. SuiteQL has no metadata service available outside of custom records and custom fields. Standard tables and fields must be hardcoded in some fashion. However, this comes with a downside in that NetSuite will throw exceptions when columns and tables that are not available based on your user permissions or NetSuite company settings are attempted to be selected.

In order to try and ensure at least that the columns displayed are available to you in your connection, a RowScan can be performed during column listing. This will ensure that any columns that are displayed for a given table are actually available based on your user credentials. Note that NetSuite does not return columns that are null. Therefore, this method may result in tables that do not have complete column information. Please be aware that SuiteQL has a maximum pagesize of 1000. Setting this value higher than 1000 will result in multiple page requests. Setting RowScanDepth to 0 will result in no rows being scanned (all available columns will be listed regardless). RowScanDepth may not be set higher than 100000.

RTK プロパティは、ビルドにライセンスを供与するために使用されます。 このプロパティの設定方法については、付属のライセンスファイルを参照してください。このランタイムキーは、OEM ライセンスを購入した場合にのみ使用できます。

利用可能なスキーマは、SuiteTalk（SuiteTalk SOAP API とSuiteScript を使う場合）およびSuiteQL（SuiteQL 経由でREST API を使う場合）です。

OAuth 2.0を使用する際には（Schema がSuiteQL に設定されている場合のみ利用可能）、NetSuite がトークンを取得するためにスコープの指定が必要となります。埋め込みトークンを使用する場合、 適切なスコープが自動で使用されます。その他の場合、スコープは指定されたOAuthClientId の設定済みスコープに 正確に合致する必要があり、合致しない場合 NetSuite はエラーを返します。利用可能な値は次のとおりです。

• restlets
• rest_webservices
• restlets rest_webservices

TLS/SSL 接続を使用する場合は、このプロパティを使用して、サーバーが受け入れるTLS/SSL 証明書を指定できます。コンピュータによって信頼されていない他の証明書はすべて拒否されます。

このプロパティは、次のフォームを取ります：

これを指定しない場合は、マシンが信用するすべての証明書が受け入れられます。

証明書は、システムのトラストストアに基づいてマシンによって信頼されていると検証されています。使用されるトラストストアは、システムに指定された'javax.net.ssl.trustStore' 値になります。このプロパティに値が指定されていない場合は、Java のデフォルトのトラストストア（例えば、JAVA_HOME\lib\security\cacerts）が使用されます。

すべての証明書の受け入れを示すには、'*'を使用します。セキュリティ上の理由から、これはお勧めできません。

SupportEnhancedSQL がtrue に設定されている場合、本製品 はNetSuite にできるだけ多くのSELECT 構文処理をオフロードし、残りのクエリをインメモリで処理します。この方法で、本製品 はサポートされていない宣言、JOIN、および集計を実行することができます。

SupportEnhancedSQL がfalse に設定されている場合、本製品 はSQL 実行をNetSuite API でサポートされている範囲に制限します。

宣言の実行

本製品 は、どの句がデータソースでサポートされているかを決定し、クエリを充足する最小セットの行を取得するためにソースにクエリを送信します。そして、残りの行をローカルでフィルタリングします。フィルタリング処理がストリームされている場合、本製品 は大きなデータセットに対しても効率よいフィルタリングが可能です。

JOIN 実行

本製品 は、インメモリでのJOIN でさまざまな技術を使用します。本製品 は、メモリ使用量と同じテーブルを複数回読む要求をトレードオフします。

集計の実行

本製品 は、インメモリで集計を処理するために必要なすべての行を取得します。

テーブルを複数のデータベースからリストすると、負荷がかかる可能性があります。接続文字列でテーブルのリストを提供すると、本製品 のパフォーマンスが向上します。

このプロパティは、作業したいビューがすでにわかっていて、ビューが多すぎる場合に、ビューを自動的にリストする代わりに使用することもできます。

カンマ区切りのリストで使用したいテーブルを指定します。各テーブルは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。 例えば、Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space` です。

複数のスキーマまたはカタログを持つデータソースに接続する場合は、複数のカタログやスキーマに存在するテーブル間の曖昧さを避けるため、最後の例のように、このプロパティにテーブルの完全修飾名を指定する必要があることに注意してください。

Timeout プロパティが0に設定されている場合は、操作がタイムアウトしません。処理が正しく完了するか、エラー状態になるまで実行されます。 Timeout の有効期限が切れても処理が完了していない場合は、本製品 は例外をスローします。

NetSuite では、子テーブルからデータを取得する場合や、AggregateColumnMode がListAndRetrieve に設定されている特定のテーブルからデータを取得する場合に、オペレーションが戻るのに非常に長い時間がかかることがあります。 例えば、AggregateColumnMode がListAndRetrieve に設定されている場合、NetSuite から単一のリクエストで1000 SalesOrders を取得するのに10分以上かかるのは前例のないことではありません。 残念ながら、これはNetSuite Web サービスの制限であり、既知の解決策はありません。集計カラムや子テーブルで作業する必要がある場合は、Timeout を0に設定して、Pagesize の値を小さくし、すべてのカラムではなく特定のカラムを選択します。

NetSuite の応答は、特に一度に多数のレコードを挿入、更新、または削除する場合に、かなり遅くなる可能性があります。 このような状況では、非同期サービスを使用してデータを送信することをお勧めします。非同期サービスは、アプリケーションの実行中にNetSuite がデータを処理できるようにします。 非同期サービスを使用することの欠点は、NetSuite のJob をチェックして、NetSuite がリクエストの処理を完了したかどうか、問題がないかどうかを確認する必要があることです。

このプロパティは、コネクションプーリングを有効にします。デフォルトはfalse です。 コネクションプールの使用に関する詳細は、 接続プール を参照してください。

通常、カスタマイズ用のLabel はカスタムレコードのテーブルやカスタムフィールドのカラムを閲覧する際に表示されます。 これはNetSuite UI と同じ表示にすることで、操作を簡単にするための設定です。しかし、厳密には同じ設定が保持される保証はありません。 NetSuite 内からラベルを変更すると、カスタムフィールドやカスタムレコードの名前が、CData のツールでも変更されます。 UseInternalNamesForCustomizations をfalse に設定すると、代わりに内部API 名（これは変更することはできません）がこれらのテーブルやカスタムフィールドに表示されます。

このフィールドは、AccountId およびPassword とともに、NetSuite に対する認証に使用されます。

NetSuite は、ユーザータイムゾーンプリファレンスに基づいて日付と時刻のオフセットを返します。これはDate とTime オブジェクトにのみ適用され、Datetime には適用されません。Datetime は個人のプリファレンスに関係なく常に同じ方法で返されます。 CData では、NetSuite UI の表示と同じになるように自動修正して日付を返します。 ただし、デイライトセービングにより24時間以上の時差があるタイムゾーンがあるため、これは100% 完璧ではありません。 ユーザープリファレンスが+13:00、+12:00、または-12:00 に設定されている場合は、この値を指定して日付を正しく表示させます。 その他のオフセットでは必須ではありませんが、最高の精度を得るため指定することをお勧めします。

Time の値を取得する場合、このプロパティは、ローカルマシンの時刻がログインユーザーのものと一致しない場合にのみ必要です。 確認するには、NetSuite UI にログインしてホームアイコンの上にマウスを置き［プリファレンス］を選択してください。ユーザーのタイムゾーンオフセットはそこで指定されます。 もし、CData JDBC Driver for NetSuite 2021J が実行されるローカルマシンが、ユーザーに設定されているタイムゾーンと同じタイムゾーンに一致しない状況にある場合は、UserTimezoneOffset をNetSuite のユーザー設定で指定されたものと一致するように設定してください。

NetSuite テーブルおよびカラムでは、 通常のデータベースでは使うことが認められていない特殊記号・文字を名前に使うことができます。UseSimpleNames を使用すると、本製品 を従来のデータベースツールでより簡単に使用できるようになります。

UseSimpleNames をtrue に設定し、返されるテーブル名およびカラム名をシンプルにします。表示されるテーブル名 およびカラム名においてアルファベット文字およびアンダースコアのみを有効とするネーミングスキームを強制します。 英数字以外の文字はすべて、アンダースコアに変換されます。

Upsert を使用すると、挿入時に既存のレコードを更新できます。NetSuite は、指定されたレコードのExternalId を使用してこれを処理します。 指定したExternalId がNetSuite に存在するときに挿入を実行すると、代わりに対応するレコードが更新されます。 それ以外の場合は、挿入が行われます。常に新しいレコードを挿入するには、この値をfalse に設定してください。

Verbosity レベルは、本製品 がLogfile にどの程度の詳細さで記載するかを決定します。1 から5 までのVerbosity レベルがサポートされています。より詳しい説明は、ログ ページに記載されています。

ほとんどの場合、バージョンを変更する必要はありません。ただし、バージョンを変更する場合は、指定したバージョンがNetSuite API に存在することを事前に確認してください。 不正なバージョンが指定された場合、本製品 はNetSuite のテーブルを取得または更新できません。

ビューを複数のデータベースからリストすると、負荷がかかる可能性があります。接続文字列でビューのリストを提供すると、本製品 のパフォーマンスが向上します。

このプロパティは、作業したいビューがすでにわかっていて、ビューが多すぎる場合に、ビューを自動的にリストする代わりに使用することもできます。

カンマ区切りのリストで使用したいビューを指定します。各ビューは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。 例えば、Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space` です。

複数のスキーマまたはカタログを持つデータソースに接続する場合は、複数のカタログやスキーマに存在するテーブル間の曖昧さを避けるため、最後の例のように、このプロパティにテーブルの完全修飾名を指定する必要があることに注意してください。

これは、何らかの理由でホストが動的に解決できない場合のWeb サービスホストのオーバーライドです。 最終手段であり、通常は指定する必要はありません。

ほとんどの場合、Web サービスのホストはNetSuite のWeb サービスのリクエストを使用して動的に決定され、お客様のアカウント用の正しいWeb サービスホストを取得します。 これにより、新しい接続を作成して確立するたびに1つの追加リクエストが発生します。 この余分なリクエストを回避したい場合やサービスホストを解決できない場合は、代わりにそれをオーバーライドするWebServiceHost を設定することができます。

Web サービスホストは以下のフォーマットに従ってください。アカウントid 内の"_" はすべて"-" に置き換えてください。 アカウントid はすべて小文字で、[アカウントid].suitetalk.api.netsuite.com としてください。

Web サービスホストを取得するには、NetSuite に管理者としてログインして、［設定］->［会社］->［会社情報］に進んでください。 会社のURL のタブ以下のSuiteTalk にURL が表示されています。