ODBC プロパティの設定
次のプロパティは接続をカスタマイズし、ODBC Driver のクエリ動作を最適化します。
ODBC アドミニストレーターのプロパティ
これらのプロパティは、DSN の ODBC データソースアドミニストレーターまたはログインダイアログボックスの [カスタムプロパティ] フィールドで指定します。
| プロパティ名 | 説明 | デフォルト |
|---|---|---|
| BatchSize | インスタンスからの結果のフェッチ中に、このバッチサイズはすべての要求でフェッチするレコードの数を設定します。通常、デフォルトは通常のサイズの行に最適な数です。レコードのフェッチ中にこの値を小さくする必要があることを示すエラーが発生した場合は、この値を変更してメモリ使用率とパフォーマンスを最適化できます。 | 2000 |
| url | これは ServiceNow インスタンス URL またはエンドポイントです。接続する ServiceNow インスタンスへの URL を示す必要があります。 | https://demo.service-now.com |
| EnablePassThrough | 集計関数の処理中にパススルーモードを有効にすると、Aggregate Web Service を直接呼び出すことができ、最適化された迅速な応答が得られます。可能な場合は常に、このモードを有効にしておく必要があります。 | true |
| debug | デフォルトでは、デバッグメッセージは生成されません。ISQL コンソールウィンドウから ODBC Driver を操作して HTTP 関連のすべてのネットワーク通信トラフィックをコンソールウィンドウに書き込む場合は、[デバッグ] を [true] に設定します。このオプションを使用する場合は、データが圧縮されないように [gzip] を [false] に設定します。それ以外の場合、データを読み取ることはできません。 | false |
| gzip | デフォルトでは、ネットワーク経由で送信されるデータは圧縮されます。[debug] パラメーターを使用してネットワーク通信を [ISQL] コンソールに書き込む場合は、データが圧縮されないように [gzip] を設定します。 | true |
| timeout | ソケットの非アクティブタイムアウト値を秒単位で指定します。 | 175 |
| retries | ソケットのタイムアウトエラーが発生した場合に失敗した要求を再試行する回数。 | 0 |
| mode | 複雑な where 句を解析するために使用されるクエリモード。AND または OR 演算子を使用するように ODBC Driver のクエリモードを設定できます。 OR 演算子は複雑なクエリとの互換性が最も優れていますが、通常は AND 演算子の方が効率が高く、データベース操作の回数が少なくなります。 |
or |
| EnableDBSchema | ODBC Driver はインスタンスからテーブル名を取得するデータベーススキーマ要求を発行します。この機能はデフォルトで有効になっているため、Microsoft Excel などのレポートアプリケーションは、クエリ元のテーブルのリストを表示できます。特にインスタンスに多数のテーブルがある場合、このプロパティを無効にすると、レポートアプリケーションから送信される最初のクエリのパフォーマンスが向上する可能性があります。 | true |
| ExtendedSchemaCache | ODBC Driver は各接続のデータベーススキーマをキャッシュします。新しい接続が作成されると、ドライバーはデータベースキャッシュをクリアし、インスタンスから再度データベーススキーマをクエリします。この動作は、別のデータソースへの接続時またはテーブルスキーマの変更時に役立ちます。一貫性のあるスキーマを使用して単一のデータソースをクエリする場合にこのプロパティを有効にすると、[EnableDBSchema] が [true] の場合を含め、不要なスキーマ要求が送信されなくなります。 | false |
| LegacyDurationTimeZone | ODBC Driver は、バージョン 1.0.10 以降、デフォルトで UTC タイムゾーンのタイマーと期間のフィールド値を返します。このプロパティが [true] の場合、ODBC Driver は UI に示されている表示値を使用してタイマーと期間のフィールド値を返します。このプロパティを使用して、表示値に依存する従来の統合との互換性を維持できます。この動作の詳細については、KB0583982 を参照してください。 | false |
接続でこれらのプロパティを複数使用する必要がある場合は、セミコロン (;) 区切り文字で設定を連結します。たとえば、次の文字列は、URL を特定のインスタンスに設定してバッチサイズを 200 レコードに変更します。
url=https://demo1234.service-now.com;BatchSize=200
ODBC 管理コンソールプロパティ
これらのプロパティには、 Windows の [スタート] メニューにある ODBC 管理コンソールからアクセスできます。 .
| プロパティ名 | 説明 | デフォルト |
|---|---|---|
| ServiceJVMOptions (Services\Service Settings\IP Parameters) |
JVM コマンドラインのプロパティとオプション。たとえば、最大 Java ヒープサイズを変更するには、-Xmx150m パラメーターを変更します。 | -Xms64m -Xmx150m |
| DataSourceIPProperties (OpenAccess SDK 6.0 Manager\<インストール場所>\Services\ServiceNow_ODBC\Data Source Settings\ServiceNow\IP Parameters) |
すべての ODBC 接続に対するインスタンス URL のグローバルデフォルト。柔軟性を高めるために、デフォルトの URL 構成で新しい DSN を作成することもできます。 | https://demo.service-now.com |
| ServiceSQLDiskCacheMaxSize (Services\Service Settings\SQL Engine Parameters) |
ディスクキャッシュファイルの最大サイズを指定します。「ディスクキャッシュファイルのサイズ制限に達しました (Disk Cache file size limit has reached)」エラーが表示された場合は、この値を増やします。 |
200 |
| Timeout (Data Source Settings\ServiceNow\IP Parameters) |
ソケットの非アクティブタイムアウト値を秒単位で指定します。「GetKeys が失敗しました (ソケットタイムアウト) (GetKeys failed (Socket timeout))」エラーが表示された場合は、この値を glide.soap.request_processing_timeout.odbc より大きくします。 |
175 |
| ServiceJVMLocation | ODBC Driver によって使用される JRE の場所が含まれています。 | このプロパティのデフォルト値はありません。インストール時に JRE の場所を入力するように求められます。 |
サービス JVM オプション
-Xmx などの標準 JVM 引数に加えて、これらの値を ServiceJVMOptions パラメーター内で指定できます。
| オプション | 説明 | デフォルト |
|---|---|---|
| -DLOG_FILE_NAME | ODBC ログファイルの場所。このプロパティは、ODBC Driver 1.0.7.1 リリース以降で使用できます。 | ${user.home}\AppData\Local\ServiceNow\odbc\logging\odbc.log |
| -DLOG_LEVEL | ODBC ログファイルへの書き込み時に使用されるログ記録レベル。ログ記録レベルは、TRACE、INFO、ERROR などの Logback レベルを使用して指定できます。このプロパティは、ODBC Driver 1.0.8 リリース以降で使用できます。 | INFO |
インスタンスのプロパティ
管理者は、ServiceNow インスタンスでプロパティを追加するか、既存のプロパティを変更することで、これらのプロパティを設定できます。
| プロパティ名 | 説明 | デフォルト |
|---|---|---|
| glide.db.max.aggregates | 集計関数によって返される行の最大数。 | 100000 |
| glide.db.max_view_records | データベースビューによって返される行の最大数。 | 10001 |