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

任意のSQLを実行 [SQL]

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

SELECT文を発行 [SQL-Record]

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

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

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

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

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

このプロパティは、お使いの環境およびID プロバイダーの要件に基づくセキュアな認証を実現します。

Microsoft SharePoint オンプレミス

Microsoft SharePoint オンプレミスインスタンスに接続する場合、このプロパティはUser およびPassword と共に、認証の処理方法を決定します。 デフォルトの認証スキームはNTLM です。利用可能なオプションは以下のとおりです。

• Basic — HTTP Basic 認証を使用します。
• None — 匿名認証を有効にします。通常、公開サイトへのアクセスに使用します。
• NTLM — 認証にWindows クレデンシャルを使用します。
• Negotiate — サーバーと認証メカニズムをネゴシエートします。Kerberos 認証を使用する場合に設定します。
• ADFS — Active Directory Federation Services（ADFS）によるシングルサインオン（SSO）を有効にします。

Microsoft SharePoint オンライン

Microsoft SharePoint オンラインに接続する場合、AzureAD がデフォルトの認証スキームです。設定されているSchema に応じて、以下のオプションを使用できます。

REST

• AzureAD — Azure Active Directory OAuth 認証を実行します。
• AzureServicePrincipalCert — 証明書を使用したAzure サービスプリンシパルとして認証します。
• AzurePassword — パスワードグラント種別でOAuth を使用して認証します。WARNING：他の（より安全な）認証方式が利用できない場合に限り、この方式を使用してください。非常に高い信頼が求められるためです。
• AzureMSI — Azure VM で実行している際に、マネージドサービスID（MSI）資格情報を自動的に取得します。
• SharePointOAuth — Microsoft SharePoint アプリクライアントクレデンシャルによるOAuth 認証を使用します。
• ADFS — Active Directory Federation Services（ADFS）によるSSOを 有効にします。
• Okta — Okta によるSSO を有効にします。
• PingFederate — PingFederate によるSSO を有効にします。
• OneLogin — OneLogin によるSSO を有効にします。

SOAP

• Basic — HTTP Basic 認証を使用します。

この接続プロパティがTrue に設定されている場合、本製品 はSELECT クエリの対象となるテーブルの内容を自動的にキャッシュします。これらのテーブルの内容は、CacheConnection およびCacheDriver 接続プロパティで指定されたキャッシュデータベースにキャッシュされます。

関連項目

• CacheMetadata：CacheMetadata を有効にすると、取得されたすべてのメタデータはキャッシュデータベースにミラーリングされます。これは、本製品 が以降にメタデータを検出しようとする場合に、メタデータがキャッシュデータベースから直接読み取られMicrosoft SharePoint にメタデータをリクエストする時間が不要になるため、より高速になることを意味します。
• 明示的なデータのキャッシュ：このセクションでは、AutoCache をOffline モードで使用する例を示します。
• CACHE ステートメント：CACHE ステートメントを使用して、SELECT クエリの対象となる任意のテーブルの内容を明示的にキャッシュできます。

Azure は、異なる地域や政府のユースケースに対応する複数のクラウド環境を提供しています。AzureEnvironment プロパティは、プロバイダーが認証時に接続する環境を決定します。 利用可能なオプションは以下のとおりです。

• GLOBAL — デフォルトのAzure パブリッククラウド環境。
• CHINA — Azure 中国のクラウド環境。
• USGOVT — Azure 米国政府クラウド。米国政府機関および契約業者によって使用されます。
• USGOVTDOD — Azure 米国国防総省（DoD）クラウド環境。

ほとんどの場合、デフォルト環境（GLOBAL）が機能します。ただし、Azure アカウントが国や政府のクラウドの一部である場合、このプロパティを適切に設定して認証エラーやURL の不一致を回避してください。

URL サフィックスの不一致の問題が発生した場合や、政府クラウドを対象とする必要がある場合は、このプロパティを使用してください。設定方法の詳細については、 Microsoft ドキュメントの「各国のクラウド」を参照してください。

テナントとは、Microsoft Entra ID（旧称：Azure AD）を通じて管理される、組織のユーザーやリソースのためのデジタルコンテナです。 各テナントには一意のディレクトリID が関連付けられており、多くの場合、カスタムドメイン（例：microsoft.com やcontoso.onmicrosoft.com）も関連付けられています。

Microsoft Entra 管理センターで、Microsoft Entra ID -> プロパティに移動し、「ディレクトリ（テナント）ID」と表示されている値をコピーすることで、ディレクトリ（テナント）ID を確認できます。

このプロパティは以下の場合に必要です。

• AuthScheme がAzureServicePrincipal またはAzureServicePrincipalCert に設定されている場合
• AuthScheme がAzureAD で、ユーザーアカウントが複数のテナントに属している場合

テナントの値は、2つの形式のいずれかで指定できます。

• ドメイン名（例：contoso.onmicrosoft.com）
• GUID 形式のディレクトリ（テナント）ID（例：c9d7b8e4-1234-4f90-bc1a-2a28e0f9e9e0）

テナントを明示的に指定することで、認証リクエストが正しいディレクトリにルーティングされるようになります。これは、ユーザーが複数のテナントに所属している場合や、サービスプリンシパルベースの認証を使用する場合に特に重要です。

この値が必要な場面で省略されると、認証に失敗したり、誤ったテナントに接続されたりする可能性があります。その結果、認可されていないまたはリソースが見つからないといったエラーが発生する可能性があります。

このプロパティは、バッチ操作中に送信される各バッチのサイズを制御します。 0より大きい値に設定すると、本製品 は全体の操作を指定された行数を含む小さなバッチに分割します。 これらの小さなバッチは個別にサーバーに送信されます。

このプロパティは、サーバーがリクエストのサイズに制限を課している場合に役立ちます。 操作を小さな単位に分割することで、これらの制限を回避してバッチ処理を成功させることができます。

利用可能なデータベーススキーマをすべてリストすると余分な時間がかかり、パフォーマンスが低下します。 接続文字列にスキーマのリストを指定することで、時間を節約しパフォーマンスを向上させることができます。

対象のキャッシュデータベースは、この接続プロパティとCacheDriver 接続プロパティの組み合わせによって決定されます。指定されたキャッシュデータベースを使用するには、両方のプロパティが必要です。

この接続プロパティで指定された接続文字列は、CacheDriver 接続プロパティで指定されたJDBC ドライバーに直接渡されます。使用可能な接続プロパティの詳細については、指定されたJDBC ドライバー のドキュメントを参照してください。

CacheDriver で指定したJDBC ドライバーがアプリケーションのクラスパスに含まれていることを確認してください。

以下に、一般的なキャッシュデータベースの設定例を示します。

Derby およびJava DB

CacheDriver とこの接続プロパティを使用して、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：キャッシュ先のMySQL データベースをホストしているサーバーのIP アドレスまたはドメイン名。
• Port：指定されたサーバー上のMySQL インスタンスが実行されているポート。
• Database：キャッシュ先のMySQL データベースの名前。指定されたサーバーでホストされているMySQL データベースの名前と一致する必要があります。
• User：選択したMySQL データベースに登録されているユーザーのユーザー名。
• Password：指定されたMySQL ユーザーに紐付けられたパスワード。

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 データベースの名前。指定されたサーバーでホストされている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 サーバーのホスト名）になります。

• User Id：選択したOracle データベースに登録されているユーザーのユーザー名。
• Password：指定されたOracle ユーザーにに紐付けられたパスワード。

PostgreSQL

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

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

jdbc:postgresql:postgres

• Host：PostgreSQL データベースをホストしているサーバーのアドレス。
• Port：指定されたホストサーバー上のPostgreSQL データベースがホストされているポート。
• Database：キャッシュ先のPostgreSQL データベースの名前。指定されたサーバーでホストされているPostgreSQL データベースの名前と一致する必要があります。
• User name：選択したPostgreSQL データベースに登録されているユーザーのユーザー名。"user" パラメータを使ってJDBC URL に指定できます。
• Password：指定されたユーザーに紐付けられたパスワード。

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

Note：指定されたJDBC ドライバーのJAR ファイルをクラスパスに追加する必要があります。CData JDBC drivers の場合、このJAR ファイルはドライバーのインストールディレクトリの"lib" サブフォルダにあります。

また、CacheConnection 接続プロパティを設定して、指定されたJDBC ドライバーの接続文字列を入力する必要があります。

例

Derby およびJava DB

Java DB は、Derby のOracle ディストリビューションです。Java DB にキャッシュするには、Derby JDBC ドライバーのJAR ファイルであるderbytools.jar をクラスパスに追加する必要があります。

Derby JDBC ドライバーのJAR ファイルは、このページからダウンロードできるdb-derby-10.17.1.0-bin.zip に同梱されています。derbytools.jar はこのzip ファイルの"lib" サブフォルダにあります。

クラスパスにderbytools.jar を追加した後、以下のようにJava DB データベースにキャッシュすることができます。

jdbc:sharepoint:CacheDriver=org.apache.derby.jdbc.EmbeddedDriver;CacheConnection='jdbc:derby:sample';User=MyUserAccount;Password=MyPassword;Auth Scheme=NTLM;URL=http://sharepointserver/mysite;

jdbc:sharepoint:CacheDriver=org.apache.derby.jdbc.EmbeddedDriver;CacheConnection='jdbc:derby:memory';User=MyUserAccount;Password=MyPassword;Auth Scheme=NTLM;URL=http://sharepointserver/mysite;

SQLite

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

jdbc:sharepoint:CacheDriver=org.sqlite.JDBC;CacheConnection='jdbc:sqlite:C:/Temp/sqlite.db';User=MyUserAccount;Password=MyPassword;Auth Scheme=NTLM;URL=http://sharepointserver/mysite;

MySQL

以下はCData JDBC Driver for MySQL のJDBC URL です。

  jdbc:sharepoint:Cache Driver=cdata.jdbc.mysql.MySQLDriver;Cache Connection='jdbc:mysql:Server=localhost;Port=3306;Database=cache;User=root;Password=123456';User=MyUserAccount;Password=MyPassword;Auth Scheme=NTLM;URL=http://sharepointserver/mysite;
  

SQL Server

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

jdbc:sharepoint:Cache Driver=com.microsoft.sqlserver.jdbc.SQLServerDriver;Cache Connection='jdbc:sqlserver://localhost\sqlexpress:7437;user=sa;password=123456;databaseName=Cache';User=MyUserAccount;Password=MyPassword;Auth Scheme=NTLM;URL=http://sharepointserver/mysite;

Oracle

次はOracle Thin Client のJDBC URL です。

jdbc:sharepoint:Cache Driver=oracle.jdbc.OracleDriver;CacheConnection='jdbc:oracle:thin:scott/tiger@localhost:1521:orcldb';User=MyUserAccount;Password=MyPassword;Auth Scheme=NTLM;URL=http://sharepointserver/mysite;

PostgreSQL

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

jdbc:sharepoint:CacheDriver=cdata.jdbc.postgresql.PostgreSQLDriver;CacheConnection='jdbc:postgresql:User=postgres;Password=admin;Database=postgres;Server=localhost;Port=5432;';User=MyUserAccount;Password=MyPassword;Auth Scheme=NTLM;URL=http://sharepointserver/mysite;

CacheLocation は単純なファイルベースキャッシュです。

本製品 はDerby データベースのOracle のディストリビューションあるJava DB をファイルベースのキャッシュに使用しています。Java DB にキャッシュするには、Derby JDBC ドライバーのJAR ファイルであるderbytools.jar をクラスパスに追加する必要があります。

Derby JDBC ドライバーのJAR ファイルは、このページからダウンロードできるdb-derby-10.17.1.0-bin.zip に同梱されています。derbytools.jar はこのzip ファイルの"lib" サブフォルダにあります。

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

関連項目

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

この接続プロパティがTrue に設定されている場合、クエリを実行すると、Microsoft SharePoint カタログのテーブルメタデータはCacheConnection とCacheDriver で指定されたキャッシュデータベースにキャッシュされ、もしこれらの接続プロパティが設定されていない場合はユーザーのホームディレクトリにキャッシュされます。

ホームディレクトリの場所はプラットフォームによって異なります。

テーブルのメタデータの取得は、テーブルがはじめてクエリされた際に一度だけ行われます。

CacheMetadata を使用するタイミング

本製品 がメタデータ検索で取得するMicrosoft SharePoint テーブルとカラムの数が多い場合、本製品 がすべてのテーブルメタデータをリストするのに時間がかかることがあります。

次のような場合に、メタデータの取得に時間がかかることがあります。

• 使用しているMicrosoft SharePoint インスタンスのテーブル数が多い。
• 本製品 が、接続プロパティによってデフォルト設定よりも多くのテーブルを検出するように設定されている。
• 本製品 に対して多くの短期間接続を行っている。

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

本製品 は、はじめてテーブルやビューのメタデータを発見したときから最大1時間、そのメタデータをメモリに自動的に保持するため、通常はCacheMetadata は必要ありません。

CacheMetadata は、変動しやすいメタデータを扱うシナリオでは理想的ではありません。はじめてテーブルをクエリするとき、本製品 はそのメタデータをキャッシュデータベースファイルにキャッシュします。このキャッシュはテーブルスキーマの更新を反映するために動的に更新されることはないため、新規、変更、削除されたカラムを取得するには、キャッシュデータベースファイルを削除して再構築する必要があります。

キャッシュ内のテーブルに対してクエリを実行すると、本製品 はキャッシュの最終更新から経過した時間を確認します。

キャッシュの最終更新がこの接続プロパティの値（秒単位）よりも前の場合、本製品 はキャッシュを更新します。

それ以外は、本製品 はキャッシュから直接データを返します。

このプロパティは非推奨です。代わりにResolveCalculatedTypes 接続プロパティを使用して、計算されたデータ型を自動的に解決できます。

SharePoint のSOAP スキーマでは、計算フィールドはUI での設定方法に応じてさまざまなデータ型を返すことができます。 デフォルトでは、本製品 はCalculated オプションを使用し、メタデータに基づいて正しい型を検出しようと試みます。 しかし、場合によっては、計算フィールドが、検出された型と一致しない不整合な値や予期しない値を返すことがあります。 このような場合、CalculatedDataType プロパティを使用して、本製品 がこれらのフィールドに使用すべきデータ型を手動で指定することができます。

パフォーマンスの考慮事項

計算フィールドのデータ型をオーバーライドすることで、型の不一致を回避してエラーを減らし、クエリの信頼性を向上させることができます。 ただし、基となるデータと矛盾するデータ型を強制すると、変換のオーバーヘッドや値の切り捨てが発生し、大規模な結果セットの場合、クエリのパフォーマンスが低下する可能性があります。 デフォルトのCalculated 設定に従うことで、本製品 がメタデータに基づいて型処理を最適化することができます。 手動のオーバーライドは、型の不整合が問題を引き起こす場合にのみ使用してください。

カスタムOAuth アプリケーションを作成した場合、OAuth 認可サーバーは認証プロセス中にユーザーをこのURL にリダイレクトします。 この値は、カスタムOAuth アプリケーションの設定時に指定したコールバックURL と一致する必要があります。

このプロパティは、接続が本製品 によって自動的に閉じられるまでのアクティブな状態を維持する時間を制御します。 時間は秒単位で指定します。このプロパティを0より大きい値に設定すると接続の有効期間が制限され、その後本製品 が接続を終了します。

デフォルトではこのプロパティは0に設定されており、接続の有効期間に制限はありません。接続は明示的に閉じられるか、ネットワークの中断やセッションのタイムアウトなどの外部要因によって終了されるまで開いたままになります。

このプロパティは、リソースの利用状況を管理し、古くなった接続やアイドル状態の接続が無期限に持続するのを防ぐのに役立ちます。

true に設定すると、プロバイダーは「接続テスト」操作を実行します。これは、データベースツールで接続性を検証するために一般的に使用されます。 この操作はセッションデータを保持しません。単に接続が確立できるかどうかを確認するだけで、NOOP（操作なし）コマンドのように機能します。

false に設定すると、接続は操作が必要になるまで遅延されます。これは、接続が頻繁に開閉されるがすぐに操作が行われないようなシナリオでパフォーマンスが向上する場合があります。

バッチ操作を実行すると、アイテムの追加、更新、削除中にエラーが発生することがあります。 ContinueOnError プロパティは、エラーが発生した後に本製品 が処理を続行するかどうかを決定します。

true に設定すると、本製品 はバッチ内の残りのアイテムの処理を続行し、すべての可能な操作を完了させます。

false に設定すると、本製品 はエラーが発生するとすぐに処理を停止します。エラーが発生する前に処理されたアイテムは、そのまま追加、更新、または削除されます。

このプロパティはSOAP スキーマとREST スキーマの両方に適用され、バッチ操作ができるだけ多くのアイテムを処理することを優先するか、エラーに対処するために直ちに停止するかを制御するのに役に立ちます。

追加情報

エラー後も処理を続行することで、中断することなく可能な限り多くのアイテムを処理し、バッチ効率を向上させることができます。 ただし、この場合失敗したエントリに対処するためのフォローアップ処理の必要性が増す可能性があります。 エラーで停止することでトラブルシューティングが簡素化されますが、スループットが低下し、バッチの再スタートやより小さなバッチサイズの使用が必要になる場合があります。

In Microsoft SharePoint, certain fields, such as Lookup columns and Person or Group columns, store values that reference items in other lists. By default, when querying these fields using the SOAP schema, the 本製品 returns both the value and a supplemental ID column containing the referenced entry’s ID from the original list.

When set to true, the 本製品 creates these ID columns alongside the referenced values, making it easier to trace relationships and perform lookups.

When set to false, only the referenced values are returned, and the related IDs are not included.

This property is useful for preserving relational context and enabling more advanced filtering or joins when working with data that includes references to other lists.

Performance Considerations

Creating supplemental ID columns may increase the size of result sets and slightly impact performance when working with large datasets or wide tables. Disabling this property can reduce result set complexity and improve performance if the additional ID information is not needed.

Microsoft SharePoint REST APIs natively support listing up to 5000 records based on list filters. For filters with 5000 or fewer records, server-side filtering provides the fastest performance.

When set to true, the 本製品 attempts to delegate filtering to the server even when the filter exceeds 5000 records. However, this will likely result in a server error, as Microsoft SharePoint typically enforces the 5000-record limit.

When set to false, if a filter exceeds 5000 records, the 本製品 queries from the entire list and applies filtering client-side. This avoids server errors, but introduces additional processing overhead.

This property is useful for scenarios where filter sizes vary and you need to control whether filtering happens server-side or client-side based on performance or reliability requirements.

Performance Considerations

Server-side filtering provides optimal performance for filters of 5000 records or fewer. Attempting to disable the limit for larger filters can result in server errors and failed queries. Client-side filtering allows queries to succeed beyond 5000 records, but increases data transfer and processing time, potentially impacting performance for large datasets.

プロキシベースのファイアウォール（またはプロキシファイアウォール）は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

プロキシベースのファイアウォール（またはプロキシファイアウォール）は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

プロキシベースのファイアウォール（またはプロキシファイアウォール）は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

プロキシベースのファイアウォール（またはプロキシファイアウォール）は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

Note：デフォルトでは、本製品 はシステムプロキシに接続します。この動作を無効化し、次のプロキシタイプのいずれかに接続するには、ProxyAutoDetect をfalse に設定します。

次の表は、サポートされている各プロトコルのポート番号情報です。

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

プロキシベースのファイアウォール（またはプロキシファイアウォール）は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

The FolderOption property determines how files and folders are displayed in query results for Microsoft SharePoint lists and libraries when using the SOAP schema. The available options include:

• FilesOnly — Returns only files from the specified list or library, excluding folders.
• FilesAndFolders — Returns both files and folders from the specified list.
• RecursiveAll — Returns all files from the specified list and all subfolders.

This property is useful for controlling the scope of query results when working with lists and libraries that contain nested folder structures.

Performance Considerations

Selecting a recursive option such as RecursiveAll can increase query execution time and result set size, especially in lists with deep folder hierarchies. Using FilesOnly or FilesAndFolders may improve performance by reducing the scope of results and lowering data retrieval overhead.

The GetColumnsMetadata property controls when the provider retrieves and caches column metadata for tables when using the REST schema. This affects how quickly queries can begin and how much upfront loading occurs. The available options include:

• OnStart — The 本製品 retrieves and caches metadata for all columns in every table before executing the first statement. This can reduce delays during queries, but may increase initial connection time.
• OnUse — The 本製品 retrieves and caches metadata for each table the first time it is queried, reducing startup time but potentially introducing a delay when the table is first accessed.

This property is useful for balancing faster connection times against the need for immediate query responsiveness across multiple tables.

Performance Considerations

Microsoft SharePoint tables can contain lookup columns, which pull data from other lists or sources. By default, the provider includes these columns when returning query results.

When set to true, the 本製品 returns all defined lookup columns along with other table columns.

When set to false, lookup columns are excluded from query results, reducing the number of fields retrieved.

This property is useful for limiting query size and avoiding issues caused by Microsoft SharePoint server restrictions on the number of lookup columns returned in a single request.

Performance Considerations

Including lookup columns can significantly increase query size and complexity, especially in lists with many lookup fields. This may lead to slower performance or server rejections if the number of included lookup columns exceeds SharePoint’s internal limits. Excluding lookup columns can improve performance and reliability when working with large or complex tables.

In the REST schema, lookup columns by default return only the record identifiers that reference data from other lists. For example:

MultiLookUpColumn=1, 2

MultiLookUpColumn = 1, 2  
MultiLookUpColumn_DisplayValue = United States, United Kingdom

This property is useful for making query results more readable and eliminating the need to perform manual lookups to resolve IDs to display values.

Performance Considerations

OAuth は、アプリケーションがHTTP サービス上のユーザーアカウントに限定的にアクセスすることを可能にする認可フレームワークです。OAuth フローは、以下の用途で使用される方法を定義します。

• ユーザーのログイン。
• 認証に使用するOAuth アクセストークンとユーザー認証情報の交換。
• アプリケーションへの限定的なアクセスの提供。

OAuth アクセスの開始と維持のオプションは、本製品 が処理するフローの部分に基づいて命名されています。

Kerberos のプロパティは、SPNEGO またはWindows 認証を使用する場合に使用されます。 本製品 は、Kerberos KDC サービス（通常はドメインコントローラーと同じ場所にあります）にセッションチケットと一時的なセッションキーを要求します。

Note： Windows 認証は、JRE 1.6 以上でのみサポートされます。

KerberosKDC が指定されていない場合、本製品 は以下の場所から自動的にプロパティを検出しようとします。

• KRB5 Config File (krb5.ini/krb5.conf)： KRB5_CONFIG 環境変数が設定され、ファイルが存在する場合、本製品 は指定されたファイルからKDC を取得します。見つからない場合は、本製品 はOS に基づいてデフォルトのMIT ロケーションからの読み取りを試みます： C:\ProgramData\MIT\Kerberos5\krb5.ini (Windows) または/etc/krb5.conf (Linux)。
• Java システムプロパティ： システムプロパティjava.security.krb5.realm およびjava.security.krb5.kdc を使用します。
• ドメイン名およびホスト： Kerberos レルムおよびKerberos KDC が別の場所から推測できなかった場合、本製品 は設定されているドメイン名およびホストからそれらを推測します。

Kerberos のプロパティは、SPNEGO またはWindows 認証を使用する場合に使用されます。 本製品 は、Kerberos KDC サービス（通常はドメインコントローラーと同じ場所にあります）にセッションチケットと一時的なセッションキーを要求します。

Note： Windows 認証は、JRE 1.6 以上でのみサポートされます。

KerberosKDC が指定されていない場合、本製品 は以下の場所から自動的にプロパティを検出しようとします。

• KRB5 Config File (krb5.ini/krb5.conf)： KRB5_CONFIG 環境変数が設定され、ファイルが存在する場合、本製品 は指定されたファイルからKDC を取得します。見つからない場合は、本製品 はOS に基づいてデフォルトのMIT ロケーションからの読み取りを試みます： C:\ProgramData\MIT\Kerberos5\krb5.ini (Windows) または/etc/krb5.conf (Linux)。
• Java システムプロパティ： システムプロパティjava.security.krb5.realm およびjava.security.krb5.kdc を使用します。
• ドメイン名およびホスト： Kerberos レルムおよびKerberos KDC が別の場所から推測できなかった場合、本製品 は設定されているドメイン名およびホストからそれらを推測します。

keytab（“key table” の略）は、1つ以上のプリンシパルの長期キーを格納します。 ほとんどの場合、エンドユーザーはクライアントシークレット（パスワード）を使用してKDCに 認証します。 ただし、自動化されたスクリプトやアプリケーションで認証や再認証が行われる場合、keytab を使用する方が効率的です。keytab はパスワードを暗号化された形式で自動的にKDC に送信します。

Keytab は通常、標準形式のファイルで表現され、type:value の形式で命名されます。 通常、type はFILE で、value はファイルの絶対パス名です。 type のもう一つの可能な値はMEMORY で、これは現在のプロセスのメモリに格納された一時的なkeytab を示します。

keytab には1つ以上のエントリが含まれ、各エントリはタイムスタンプ（エントリがkeytab に書き込まれた時刻を示す）、プリンシパル名、キーバージョン番号、暗号化タイプ、および暗号化キー自体で構成されます。 これらはkutil を使用して生成できます。

例：

[admin@myhost]# ktutil

ktutil: addent -password -p starlord/myhost.galaxy.com@GALAXY.COM -k 1 -e aes256-cts-hmac-sha1-96
Password for starlord/myhost.galaxy.com:

ktutil: addent -password -p starlord/myhost.galaxy.com@GALAXY.COM -k 1 -e aes128-cts-hmac-sha1-96
Password for starlord/myhost.galaxy.com:

ktutil: addent -password -p starlord/myhost.galaxy.com@GALAXY.COM -k 1 -e des3-cbc-sha1
Password for starlord/myhost.galaxy.com:

ktutil: wkt /path/to/starlord.keytab

Note： サポートしたいすべての認証方法（暗号化タイプ）に対してプリンシパルを作成する必要があります。

keytab を表示するには、klist -k を使用します。

レルムとは、ドメインに似た論理的なネットワークで、同じマスターKDC の下にあるシステムのグループを定義します。一部のレルムは階層構造を持ち、一方のレルムが他方の上位集合となることもありますが、通常は非階層型（「直接型」）であり、2つのレルム間のマッピングを定義する必要があります。 Kerberos のクロスレルム認証により、異なるレルム間での認証が可能になります。各レルムは、相手レルムのプリンシパル情報を自レルムのKDC に登録しておく必要があります。

Kerberos のプロパティは、SPNEGO またはWindows 認証を使用する場合に使用されます。 本製品 は、Kerberos KDC サービス（通常はドメインコントローラーと同じ場所にあります）にセッションチケットと一時的なセッションキーを要求します。 Kerberos レルムは、管理者が任意の文字列に設定できますが、通常はドメイン名に基づいて設定されます。

Kerberos レルムが指定されていない場合、本製品 は、これらのプロパティを自動的に次の場所から検出しようとします。

• KRB5 Config File (krb5.ini/krb5.conf)： KRB5_CONFIG 環境変数が設定され、ファイルが存在する場合、本製品 は指定されたファイルからデフォルトレルムを取得します。それ以外の場合は、OS に基づいてデフォルトのMIT ロケーションからの読み取りを試みます：C:\ProgramData\MIT\Kerberos5\krb5.ini (Windows) または/etc/krb5.conf (Linux)
• Java システムプロパティ： システムプロパティjava.security.krb5.realm およびjava.security.krb5.kdc を使用します。
• ドメイン名およびホスト： Kerberos レルムおよびKerberos KDC が別の場所から推測できなかった場合、本製品 はユーザー設定されているドメイン名およびホストからそれらを推測します。これは、一部のWindows 環境で機能します。

KerberosServiceKDC は、クロスレルムKerberos 認証を使用する際にサービスKerberos KDC を指定するために使われます。

ほとんどの場合、Kerberos 認証の実行には単一のレルムとKDC マシンが使用されるため、このプロパティは必要ありません。ただし、認証チケット（AS リクエスト）とサービスチケット（TGS リクエスト）の取得に異なるレルムとKDC マシンが使用される複雑なセットアップではこのプロパティを使用できます。

KerberosServiceRealm は、クロスレルムKerberos 認証を使用する際にサービスのKerberosRealm を指定するために使われます。

ほとんどの場合、Kerberos 認証の実行には単一のレルムとKDC マシンが使用されるため、このプロパティは必要ありません。ただし、認証チケット（AS リクエスト）とサービスチケット（TGS リクエスト）の取得に異なるレルムとKDC マシンが使用される複雑なセットアップではこのプロパティを使用できます。

Kerberos ドメインコントローラー上のSPN が認証先のURL と異なる場合は、このプロパティを使用してSPN をKDC のURL に設定します。

Kerberos ドメインコントローラー上のSPN が認証先のURL と異なる場合は、このプロパティを使用してSPN をKDC のURL に設定します。

MIT Kerberos Ticket Manager またはkinit コマンドを使用して作成された認証情報キャッシュファイルを使用する場合は、このプロパティを設定します。

Kerberos プリンシパルが存在する場合、データベースへの認証には常にそのKerberos プリンシパル名を使用する必要があります。

Location プロパティは、定義をカスタマイズしたり（例えば、カラム名を変更する、カラムを無視するなど）、新しいテーブル、ビュー、またはストアドプロシージャでデータモデルを拡張する場合にのみ必要です。

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

• 各スキーマには、そのスキーマ名に対応するフォルダが作られます。
• すべてのスキーマフォルダは、親フォルダに含まれる必要があります。

Location は常に親フォルダに設定されるべきで、個々のスキーマのフォルダに設定すべきではありません。

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

このプロパティは、認証イベント、クエリ実行、接続の詳細など、本製品 の操作を記録するログファイルの場所と名前を指定します。 指定されたファイルが存在しない場合、本製品 はそのファイルを作成します。本製品 を実行しているユーザーまたはサービスが、指定されたパスまたはファイルへの書き込み権限を持っていることを確認してください。 適切な権限がない場合、ログファイルは作成されません。パスワードやトークンなどの接続文字列の機密情報は、ログで自動的にマスキングされます。 ただし、データ自体に含まれる機密情報はマスキングされない可能性があります。

Logfile に相対パスを指定し、Location プロパティが設定されている場合、そのディレクトリがログファイルのベースパスとして使用されます。

追加プロパティにより、ログの動作をカスタマイズできます。

• ログファイルの詳細レベルを制御するには、Verbosity を使用します。
• MaxLogFileSize でログファイルのサイズを管理し、MaxLogFileCount で保持するログファイルの数を制御します。
• LogModules プロパティを調整することで、特定のログモジュールをフィルタリングします。

Java のログ出力

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

Logfile=JAVALOG://myloggername

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

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

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

このプロパティは、含めるログモジュールを指定することでログファイルの内容をカスタマイズすることができます。 ログモジュールは、クエリ実行、メタデータ、SSL 通信などの異なる領域にログ情報を分類します。 各モジュールは4文字のコードで表され、文字の名前の場合は末尾にスペースが必要なものもあります。

例えば、EXEC はクエリ実行をログに記録し、INFO は一般的なプロバイダーメッセージをログに記録します。 複数のモジュールを含めるには、次のように名前をセミコロンで区切ります：INFO;EXEC;SSL。

Verbosity 接続プロパティは、このプロパティで指定されたモジュールベースのフィルタリングよりも優先されます。 Verbosity レベルを満たし、指定されたモジュールに属するログエントリのみが記録されます。 利用可能なすべてのモジュールをログファイルに含めるには、このプロパティを空白のままにします。

利用可能なモジュールの完全なリストとログの設定に関する詳細な手引きについては、ログ の「高度なログの記録」セクションを参照してください。

各ログファイル名には、識別しやすいように日付と時刻が含まれています。

このプロパティには以下の値を指定できます。

• 2以上の値を設定すると、保持されるログファイルの最大数が設定されます。
• 値が1の場合、ログファイルは1つだけ保持されます。最大サイズに達すると、ファイルは削除され新しいファイルに置き換えられます。これにより、現在のログ以外の履歴は残りません。
• 0または負の値を設定すると、ログファイルの数に制限がなくなりログ記録が無期限に続きます。

ログファイルのサイズを管理するには、MaxLogFileSize プロパティを使用します。これらの2つのプロパティは、ログフォルダ内のログファイルのサイズと保持を制御するために連携して動作します。

100 KB より小さい値の場合、本製品 は100 KB を最小許容サイズとして使用します。

保持されるログファイルの総数を制御するには、このプロパティとMaxLogFileCount プロパティを組み合わせて使用します。 これらのプロパティを組み合わせることで、ログファイルのサイズと保持を効果的に管理できます。

このプロパティは、集計やGROUP BY 句を含まないクエリに対して本製品 が返す行数の上限を設定します。 この制限により、クエリがデフォルトで過度に大きな結果セットを返さないようにします。

クエリにLIMIT 句が含まれている場合、クエリで指定された値がMaxRows 設定よりも優先されます。 MaxRows が"-1" に設定されている場合、LIMIT 句が明示的にクエリに含まれていない限り、行の制限は行われません。

このプロパティは、非常に大きなデータセットを返す可能性のあるクエリを実行する際に、パフォーマンスを最適化し過剰なリソース消費を防ぐのに役立ちます。

OAuthAccessToken は、保護されたリソースへのアクセスを認可する一時的な認証情報です。 これは通常、ユーザーまたはクライアントアプリケーションがOAuth 認証フローを完了した後に、ID プロバイダーから返されます。 このプロパティは、自動化されたワークフローや、トークンの処理をドライバーの外部で管理したいカスタムOAuth 実装で最も一般的に使用されます。

OAuth アクセストークンにはサーバーに依存する時間制限があり、ユーザーのアクセスを制限します。これは、OAuthExpiresIn プロパティを使用して設定します。ただし、ユーザーが操作を続けている限り、リクエスト間で再発行することでアクセスを維持することができます。

InitiateOAuth がREFRESH に設定されている場合、OAuthExpiresIn とOAuthTokenTimestamp の両方を設定することを推奨します。 本製品 は、これらのプロパティを使用してトークンの有効期限を判断し、最も効率的にリフレッシュできるようにします。OAuthExpiresIn およびOAuthTokenTimestamp が指定されていない場合、本製品 はトークンを直ちにリフレッシュします。

Note：アクセストークンは機密性の高い認証情報として扱い、安全に保管する必要があります。アクセス制御されていないログ、スクリプト、または設定ファイルでの公開は避けてください。

このプロパティは以下の場合に必要です。

• カスタムOAuth アプリケーションを使用する場合。たとえば、Web ベースの認証フロー、サービスベースの認証、またはアプリケーションの登録が必要な証明書ベースのフローなどが該当します。
• 接続の確立 に記載されているように、ドライバーで組み込みOAuth 認証情報が利用できない場合。

（組み込みOAuth 認証情報が存在する場合、アプリケーション登録情報は既に本製品 によって提供されており、手動で入力する必要がない場合があります。）

この値は、認証付きの接続を構成する際に、OAuthClientSecret やOAuthSettingsLocation などの他のOAuth 関連プロパティと一緒に使用されるのが一般的です。

OAuthClientId は、ユーザーがOAuth 経由で認証を行う前に設定する必要がある、主要な接続パラメータの1つです。この値は、通常、ID プロバイダーのアプリケーション登録設定で確認できます。Client ID、Application ID、Consumer Key などとラベル付けされた項目を探してください。

Note：クライアントID は、クライアントシークレットのような機密情報とは見なされませんが、アプリケーションの識別情報の一部であるため、慎重に取り扱う必要があります。公開リポジトリや共有設定ファイルでこの値を露出させないようにしてください。

このプロパティは、安全なクライアント認証を必要とするすべてのフローでカスタムOAuth アプリケーションを使用する場合に必要です。たとえば、Web ベースのOAuth、サービスベースの接続、証明書ベースの認可フローなどが該当します。 組み込みOAuth アプリケーションを使用する場合は必要ありません。

クライアントシークレットは、OAuth フローのトークン交換ステップで使用されます。このステップでは、ドライバーが認可サーバーにアクセストークンを要求します。 この値が欠落しているか正しくない場合、認証はinvalid_client またはunauthorized_client エラーで失敗します。

OAuthClientSecret は、ユーザーがOAuth 経由で認証を行う前に設定する必要がある、主要な接続パラメータの1つです。この値は、OAuth アプリケーションを登録する際にID プロバイダーから取得できます。

Notes：

• この値は安全に保管し、公開リポジトリやスクリプト、安全でない環境では決して公開しないようにしてください。
• クライアントシークレットは、一定期間が経過すると有効期限が切れる場合もあります。 アクセスを中断させないために、有効期限を常に監視し、必要に応じてシークレットをローテーションするようにしてください。

OAuth アクセストークンは認証済みのユーザーに割り当てられ、そのユーザーに指定された期間のネットワークへのアクセスを許可します。アクセストークンはユーザーのログインID とパスワードの代わりに使用され、サーバーに保持されます。

サーバーによって作成されたアクセストークンは、限定された時間のみ有効です。OAuthExpiresIn は、トークンが作成されてから有効である秒数です。例えば、2024-01-29 20:00:00 UTC に生成され、2024-01-29 21:00:00 UTC（1時間後）に期限切れとなるトークンは、現在の時刻に関係なくOAuthExpiresIn の値は3600です。

ユーザーがアクセストークンの有効期限が切れるまでの時間を確認するには、OAuthTokenTimestamp をチェックします。

OAuthJWTCertType フィールドは、OAuthJWTCert により指定された証明書ストアの種類を指定します。 ストアがパスワードで保護されている場合は、OAuthJWTCertPassword を使用してパスワードを指定します。

OAuthJWTCert は、OAuthJWTCertSubject フィールドとともにクライアント証明書を指定するために使われます。 OAuthJWTCert に値が設定され、かつOAuthJWTCertSubject が設定されている場合、CData JDBC Driver for Microsoft SharePoint 2025J は証明書の検索を開始します。 詳しくは、OAuthJWTCertSubject を参照してください。

証明書ストアの指定はプラットフォームに依存します。

注記

• Windows の共通のユーザーとシステム証明書ストアは以下のとおりです。
  • MY：個人証明書と関連付けられた秘密キーを 格納している証明書ストア。
  • CA：証明機関の証明書。
  • ROOT：ルート証明書。
  • SPC：ソフトウェア発行元証明書。
• Javaでは、証明書ストアは通常、証明書および 任意の秘密キーを含むファイルです。
• 証明書ストアの種類がPFXFile の場合は、 このプロパティにファイル名を設定します。
• PFXBlob の場合は、このプロパティをPFX ファイルのバイナリコンテンツ（例えば、PKCS12証明書ストア）に設定する必要があります。

このプロパティは、パスワードで保護された証明書ストアを開くために必要なパスワードを指定します。 パスワードが必要かどうかを判断するには、ご利用の証明書ストアのドキュメントまたは設定を参照してください。

Java Web Token の発行者。 ほとんどの場合、これはOAuth App Id（クライアントId）接続プロパティの値を使用するため、個別に設定する必要はありません。

現在のアクセストークンが期限切れになったときに、新しいアクセストークンを取得するためにリフレッシュトークンが使用されます。 これにより、ユーザーが再度ログインすることなく、長時間実行されるワークフローや自動化された処理において、シームレスな認証が可能になります。 このプロパティは、対話型の認証ができないヘッドレス環境、CI/CD、またはサーバーベースの環境において特に重要です。

リフレッシュトークンは通常、初回のOAuth 交換時にGetOAuthAccessToken ストアドプロシージャを呼び出すことで取得されます。 その後、このプロパティを使用してトークンを自動でリフレッシュするか、（手動で更新を管理したい場合は）OAuthRefreshToken ストアドプロシージャに渡すことができます。

InitiateOAuth がREFRESH に設定されている場合、ドライバーはこのトークンを使用して、新しいアクセストークンを自動的に取得します。 最初のリフレッシュの後、ドライバーは更新されたトークンをOAuthSettingsLocation によって定義された場所に保存し、その後の接続ではその値を使用します。

Note：OAuthRefreshToken は安全に取り扱い、信頼できる場所に保管する必要があります。 アクセストークンと同様に、リフレッシュトークンもID プロバイダーのポリシーによって、有効期限が切れたり、取り消されたりする場合があります。

以下のいずれかの方法でOAuth の値をセントラルファイルに保存し、その値へのアクセスを共有できます。

• InitiateOAuth をGETANDREFRESH またはREFRESH に設定し、OAuth 設定ファイルのファイルパスを指定します。
• メモリストレージを使用して、資格情報を静的メモリにロードします。

以下のセクションでは、それぞれの方法について詳しく説明します。

OAuthSettingsLocation ファイルパスの指定

• Windows（ODBC およびPower BI）：registry://%DSN%
• Windows：%APPDATA%CDataSharePoint Data Provider\OAuthSettings.txt
• Mac：%APPDATA%/CData/SharePoint Data Provider/OAuthSettings.txt
• Linux：%APPDATA%/CData/SharePoint Data Provider/OAuthSettings.txt

メモリストレージ経由での資格情報のロード

資格情報が接続間で永続化されるファイルベースのストレージとは異なり、メモリストレージは資格情報を静的メモリにロードし、資格情報はプロセスが継続している間は同じ識別子を使用して接続間で共有されます。そのプロセス外で資格情報を永続化するには、接続を閉じる前に資格情報を手動で保存する必要があります。これにより、プロセスが再開されたときに接続にそれらを設定することができます。

OAuth プロパティの値を取得するには、sys_connection_props システムテーブルをクエリします。複数の接続で同じ資格情報を使用している場合は、プロパティは最後に閉じた接続から読み取られます。

サポートされるストレージの種類

• memory://：OAuth トークンをメモリ内に保存します（一意の識別子、同一プロセス内で共有など）。
• registry://：Windows ODBC およびPower BI エディションでのみサポートされています。DSN 設定のレジストリにOAuth トークンを格納します。registry://CData JDBC Driver for Microsoft SharePoint 2025J Data Source、またはregistry://%DSN% のようなDSN 名で終わる必要があります。
• %DSN%：接続先のDSN 名。
• デフォルト（接頭辞なし）：OAuth トークンをファイル内に格納します。値には絶対パス、または%APPDATA% か%PROGRAMFILES% で始まるパスのいずれかを指定できます。

OAuth アクセストークンは認証済みのユーザーに割り当てられ、そのユーザーに指定された期間のネットワークへのアクセスを許可します。アクセストークンはユーザーのログインID とパスワードの代わりに使用され、サーバーに保持されます。

サーバーによって作成されたアクセストークンは、限定された時間のみ有効です。OAuthTokenTimestamp は、サーバーがトークンを作成した時のUnix タイムスタンプです。例えば、OAuthTokenTimestamp=1706558400 は、OAuthAccessToken がサーバーによって2024-01-29 20:00:00 UTC に生成されたことを示します。

OAuthVerifier 値の取得方法の詳細については、 を参照してください。

この接続プロパティががTrue に設定されている場合、すべてのクエリは、ライブMicrosoft SharePoint データではなくキャッシュデータベースに対して実行されます。

このモードでは、INSERT、UPDATE、DELETE、CACHE などの一部のSQL 操作が無効になります。

このプロパティは、シニアユーザーが特定のシナリオに対して隠しプロパティを設定できるようにします。 これらの設定は通常のユースケースには必要ありませんが、特定の要件に対応したり、追加の機能を提供したりすることができます。 複数のプロパティをセミコロン区切りのリストで定義できます。

Note： 特定のシナリオや問題に対処するためにサポートチームから助言があった場合にのみ、これらのプロパティを設定することを強く推奨します。

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

キャッシュの設定

統合およびフォーマット

クエリを処理する際、Microsoft SharePoint でクエリされたデータすべてを一度にリクエストする代わりに、本製品 はクエリされたデータをページと呼ばれる部分ごとにリクエストすることができます。

この接続プロパティは、本製品 がページごとにリクエストする結果の最大数を決定します。

大きなページサイズを設定すると全体的なクエリ実行時間が短縮される可能性がありますが、その場合、クエリ実行時に本製品 がより多くのメモリを使用することになり、タイムアウトが発生するリスクがあることに注意してください。

Password プロパティはUser プロパティと共に使用され、サーバーに対して認証を行います。 パスワードは、Microsoft SharePoint に設定されたユーザーアカウントまたは関連するID プロバイダーに関連付けられた資格情報と一致している必要があります。

このプロパティは、UseConnectionPooling が有効な場合にのみ適用されます。接続プーリングは、リクエストごとに新しい接続を作成するのではなく、確立されたデータベース接続を再利用するメカニズムです。 これにより、頻繁な接続作成に伴うオーバーヘッドを削減し、パフォーマンスが向上します。

PoolIdleTimeout は、使用されていない接続を閉じてリソースを管理するのに役立ち、アイドル接続を維持することによる潜在的なオーバーヘッドを削減します。 値を小さくするとアイドル状態の接続を迅速にクリーンアップできます。一方、値を大きくすると接続を長く開いておけるため、再接続が頻繁に発生するシナリオではパフォーマンスが向上する可能性があります。

このプロパティは、接続プールで維持できるアクティブな接続の最大数を定義します。 このプロパティは、UseConnectionPooling がtrue に設定されている場合にのみ適用されます。 上限に達すると、新しい接続リクエストは既存の接続がプールに戻されるのを待つ必要があります。

プロパティを0または負の値に設定して接続プールを無効にすると接続の管理を簡素化できますが、トラフィックが多いシナリオではパフォーマンスが低下する可能性があります。 このプロパティは、リソースの使用率を最適化し、アプリケーションがサーバーやネットワークの制限を超えないようにするのに役立ちます。

このプロパティは、指定された最小数の接続が常に接続プールで利用可能であることを確実にします。 この設定は、接続を事前に初期化してすぐに使用できる状態に保つことで、待ち時間を減らすのに役立ちます。

デフォルトでは、プロバイダーはプールに少なくとも1つの接続を維持します。 より大きな値を設定することで、一貫したトラフィックがある環境でのパフォーマンスを向上させることができますが、リソースの使用量が増加する可能性があります。 値を小さくすると、非アクティブ時にプールがすべての接続を解放し、リソースの消費を抑えることができます。

このプロパティは、新しい接続リクエストがプールの利用可能な接続を待機する時間を制御します。 指定された時間内に接続が利用可能にならない場合、本製品 はエラーを返します。

デフォルト値は60秒で、接続リクエストが無期限に待機しないようにします。 トラフィックが多い環境やプールサイズが限られている場合、この値を大きくすることで接続が利用可能になるまでの時間を延ばすことができますが、失敗したリクエストのエラー処理が遅れる可能性があります。

認証タイプは次のいずれかです。

• BASIC：本製品 はHTTP BASIC 認証を行います。
• DIGEST：本製品 はHTTP DIGEST 認証を行います。
• NTLM：本製品 はNTLM トークンを取得します。
• NEGOTIATE：本製品 は認証において有効なプロトコルに応じて、NTLM もしくはKerberos トークンを取得します。
• NONE：ProxyServer が認証を必要としない場合に設定します。

"NONE" 以外のすべての値については、ProxyUser およびProxyPassword 接続プロパティも設定する必要があります。

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

この接続プロパティをTrue に設定すると、本製品 は既存のプロキシサーバー構成についてシステムプロキシ設定をチェックします（プロキシサーバーの詳細を手動で入力する必要はありません）。

この接続プロパティは他のプロキシ設定より優先されます。特定のプロキシサーバーに接続するために本製品 を構成する場合は、ProxyAutoDetect をFalse に設定します。

このプロパティがTrue に設定されている場合、使用するプロキシはこれらの場所をこの順番でチェックして決定されます。ある場所でプロキシが決定できない場合、本製品 は次の場所をチェックします。

1. 本製品 は、JVM のプロパティ（http.proxy、https.proxy、socksProxy など）から検索を行います。
2. JVM のプロパティが存在しない場合、本製品 はjava.home/lib/net.properties を検索します。
3. java.net.useSystemProxies がTrue に設定されている場合、本製品 はSystemProxy を検索します。
4. Windows では、本製品はレジストリのインターネットオプション、具体的にはレジストリキーHKCU\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\ からプロキシ設定を読み取ります。Windows 10以降では、Windows の設定にあるプロキシの設定に対応します。

これらの設定は、マシンの現在のユーザーにのみ適用されることに注意してください。アプリケーションをサービスとして実行している場合、本製品 はユーザー設定を読み込みません。代わりに、本製品 の接続プロパティでプロキシ設定を手動で行う必要があります。

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

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

Note：本製品 はデフォルトでシステムプロキシ設定を使用するため、それ以上の設定は必要ありません。 この接続にプロキシ例外を明示的に設定する場合は、ProxyAutoDetect をFalse に設定します。

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

ProxyAuthScheme で利用可能な認証タイプを1つ選択した後、このプロパティを以下のように設定します。

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

本製品 は、ProxyAutoDetect がFalse に設定されている場合にのみ、このパスワードを使用します。 ProxyAutoDetect がTrue（デフォルト）に設定されている場合、本製品 は代わりにシステムのプロキシ設定で指定されているパスワードを使用します。

ProxyAutoDetect がFalse に設定されている場合、本製品 はこの接続プロパティで指定されたProxyServer ポートを通じてのみHTTP トラフィックをルーティングします。

ProxyAutoDetect がTrue（デフォルト）に設定されている場合、本製品 は代わりにシステムプロキシ設定で指定されたプロキシサーバーポートを介してHTTP トラフィックをルーティングします。

その他のプロキシタイプについては、FirewallType を参照してください。

ProxyAutoDetect がFalse に設定されている場合、本製品 はこの接続プロパティで指定されたプロキシサーバーを通じてのみHTTP トラフィックをルーティングします。

ProxyAutoDetect がTrue（デフォルト）に設定されている場合、本製品 は代わりにシステムプロキシ設定で指定されたプロキシサーバーを介してHTTP トラフィックをルーティングします。

このプロパティは、ProxyServer で指定されたHTTP プロキシへの接続にSSL を使用するかどうかを決定します。この接続プロパティには、以下の値を設定できます。

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

ProxyAuthScheme で利用可能な認証タイプを1つ選択した後、このプロパティを以下のように設定します。

本製品 は、ProxyAutoDetect がFalse に設定されている場合にのみ、このユーザー名を使用します。 ProxyAutoDetect がTrue（デフォルト）に設定されている場合、本製品 は代わりにシステムのプロキシ設定で指定されているユーザー名を使用します。

このプロパティを使用すると、本製品 がテーブルカラムとして公開する擬似カラムを定義できます。

個々の擬似カラムを指定するには、以下の形式を使用します。"Table1=Column1;Table1=Column2;Table2=Column3"

すべてのテーブルのすべての擬似カラムを含めるには、次のようにします："*=*"

true に設定すると、本製品 はSELECT クエリのみを許可します。INSERT、UPDATE、DELETE、またはストアドプロシージャのクエリを実行しようとすると、失敗してエラーメッセージが表示されます。

true に設定した場合、本製品 は計算列の数式の結果型（数値、通貨、日時、はい / いいえなど）を分析して計算列の適切なデータ型を自動的に判断し、それらを適切なネイティブSQL 型にマッピングします。

false（デフォルト）に設定した場合、すべての計算列は実際のコンテンツ型に関係なくテキスト文字列として扱われます。

このプロパティを有効にすると、計算フィールドがクエリと結果で実際のデータ型を使用するようになります。

ほとんどの構成で標準的なライセンス機構をサポートしているため、通常はこのプロパティは不要です。 このプロパティの設定方法については、同梱のライセンスドキュメントを参照してください。このランタイムキーは、OEM ライセンスを購入した場合にのみ使用できます。

Warning： このプロパティの値は既存のすべてのライセンス情報よりも優先されます。ライセンスエラーを避けるため、提供されたランタイムキーが正しいことを確認してください。

Schema プロパティは、本製品 がデータの取得と管理にどのMicrosoft SharePoint API を使用するかを決定します。利用可能なオプションは以下のとおりです。

• SOAP — Microsoft SharePoint SOAP API を使用します。このスキーマはレガシー環境に適しており、REST API では利用できない特定の機能をサポートしています。
• REST — Microsoft SharePoint REST API を使用します。このスキーマはより新しい環境に推奨されることが多く、最新のREST ベースの操作をサポートしています。

Scope プロパティは、Microsoft SharePoint への認証時にOAuth フローで要求されるアクセス許可のセットを決定します。このプロパティが指定されていないか、NONE に設定されている場合、本製品 は自動的にAuthScheme プロパティに基づいてデフォルトスコープを選択します。このデフォルトスコープは.default です。

この接続プロパティの有効なオプションは以下のとおりです。

• AllSites.Read — カスタムリストからの読み取りを有効にします。
• AllSites.Write — カスタムリストからの読み取りおよびカスタムリストへの書き込みを有効にします。
• AllSites.Manage — カスタムリストの読み込み、書き込み、作成を有効にします。
• .default — ユーザーコンテキストなしでアプリケーションのアクセス許可を要求します。そのWeb API に対して付与されたすべてのアプリケーションアクセス許可は、取得したOAuthAccessToken に含まれます。

このプロパティは、OAuth フロー中にプロバイダーが要求するアクセスレベルを制御し、返されるトークンが目的の操作に適したアクセス許可を持つようにするために役立ちます。

追加情報

AllSites.Manage などのより許容範囲が広いスコープを選択すると、リストへのフルアクセスや作成機能が可能になり操作が簡素化されますが、セキュリティ上の懸念が生じる可能性があります。 スコープを読み取りまたは書き込みに制限することで、潜在的な露出を減らすことができますが、特定の操作には再認証やスコープの変更が必要になる場合があります。 .default を使用すると、本製品 が事前承認されたアプリのアクセス許可に依存できるため、認証を効率化できますが、適切なAzure アプリの構成が必要です。

SharePointEdition プロパティは、本製品 が接続する環境の種類を決定します。利用可能なオプションは以下のとおりです。

• Microsoft SharePoint Online — クラウドベースの環境に接続するには、この設定を使用します。
• Microsoft SharePoint On-Premise — オンプレミスのサーバー展開に接続するには、この設定を使用します。

追加情報

正しいエディションを選択することで、適切なAPI 処理を確実に行い、認証の失敗や予期しないエラーを回避できます。 誤った設定を使用すると、プロバイダーが互換性のないエンドポイントやプロトコルを使用しようとするため、接続に問題が生じたり、再試行回数が増えたりする可能性があります。

The ShowHiddenColumns property determines whether hidden columns in Microsoft SharePoint lists or libraries are displayed in metadata and query results.

When set to true, hidden columns are included, allowing access to fields that are not visible by default in the Microsoft SharePoint UI.

When set to false, hidden columns are excluded from the column listing.

This property applies to both the SOAP and REST schemas and is useful for advanced querying scenarios where hidden metadata fields or internal columns need to be accessed or analyzed.

Performance Considerations

Including hidden columns may increase result set size and metadata processing time, especially for lists with many internal or system fields. Excluding hidden columns can improve performance and simplify result sets, reducing unnecessary overhead in most use cases.

The ShowPredefinedColumns property determines whether predefined columns, those derived from a base type, are included in the metadata and query results. Predefined columns are typically system fields, such as CreatedBy, Author, and Modified, but can also include common columns like Title.

When set to true, these columns are included in the column listing.

When set to false, all columns derived from a base type are removed from the column listing, resulting in a cleaner, more focused set of fields.

This property applies to both the SOAP and REST schemas and is useful for simplifying metadata and query output by excluding default system columns when they are not needed.

Performance Considerations

Excluding predefined columns can reduce metadata size and simplify query results, which may improve performance and readability, especially in environments with large tables and many system-defined fields. Including them provides access to additional metadata, but can increase result set complexity.

The ShowVersionViews property determines whether the 本製品 includes version views for Microsoft SharePoint lists during metadata discovery.

When set to true, version views are included, and versioned lists appear as additional views in the metadata, typically with names like ListName_Versions.

When set to false, these version views are excluded from the metadata listing.

This property applies only to the SOAP schema and is useful for accessing historical versions of list items when versioning is enabled.

Performance Considerations

Including version views may increase metadata discovery time and the number of views returned, particularly in environments with many versioned lists. Excluding version views helps streamline metadata loading and reduces complexity when version history is not required.

このプロパティは、SSL クライアント認証のためのクライアント証明書ストアを指定します。 このプロパティは、証明書ストアの種類を定義するSSLClientCertType、およびパスワードで保護されたストア用のパスワードを指定するSSLClientCertPassword と一緒に使用します。 SSLClientCert が設定され、SSLClientCertSubject が設定されている場合、ドライバーは指定されたサブジェクトに一致する証明書を検索します。

証明書ストアの指定はプラットフォームによって異なります。 Windowsでは、証明書ストアはMY（個人証明書）などの名前で識別されますが、Java では、証明書ストアは通常、証明書とオプションの秘密キーを含むファイルです。

Windows の共通のユーザとシステム証明書ストアの指定は以下のとおりです。

PFXFile タイプの場合、このプロパティをファイル名に設定します。PFXBlob タイプの場合は、このプロパティをPKCS12 形式のファイルのバイナリコンテンツに設定します。

このプロパティは、パスワードで保護された証明書ストアを開くために必要なパスワードを指定します。 このプロパティは、PFX やJKS タイプのストアによく推奨されるように、復号化のためにパスワードを必要とする証明書ストアを使用する場合に必要です。

証明書ストアの種類がパスワードを必要としない場合（Windows のUSER やMACHINE など）、このプロパティは空白のままにできます。 認証エラーを回避するため、パスワードが指定された証明書ストアに関連付けられたものと一致していることを確認してください。

このプロパティは、サブジェクトに基づいてロードするクライアント証明書を決定します。本製品 は、指定されたサブジェクトに完全に一致する証明書を検索します。 完全に一致するものが見つからない場合、本製品 はサブジェクトの値を含む証明書を検索します。 一致する証明書がない場合、証明書は選択されません。

サブジェクトは、識別名フィールドと値のカンマ区切りリストという標準の形式に従うべきです。 例えば、CN=www.server.com, OU=Test, C=US です。一般的なフィールドには以下のものが含まれます。

Note： フィールドにカンマなどの特殊文字が含まれている場合は、値を引用符で囲む必要があります。例：CN="Example, Inc.", C=US。

このプロパティは、クライアント証明書を指定するために使用されるキーストアの形式と場所を決定します。 サポートされている値には、プラットフォーム固有およびユニバーサルなキーストア形式があります。 有効な値と使用方法は以下のとおりです。

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

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

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

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

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

SSODomain プロパティは、シングルサインオン（SSO）経由で認証を行い、ユーザーのログイン資格情報のドメイン（例えば、user@mydomain.com）がSSO サービスで構成されたドメイン（例えば、user@myssodomain.com）と異なる場合に使用されます。

このプロパティは、AuthScheme プロパティがADFS、OneLogin、Okta などのSSO 認証スキームに設定されている場合にのみ適用されます。

このプロパティは、ユーザー資格情報とSSO サービスドメインが一致しない場合に、適切な認証ルーティングを確保するために役立ちます。

追加情報

正しいSSO ドメインを指定することで、認証の失敗や不要な再試行を回避し、接続確立時間を改善できます。 必要な場合にこのプロパティを未設定のままにしておくと、ログインに何度も失敗したり、認証処理が遅くなったりする可能性があります。

ID プロバイダーのログインURL。

ID プロバイダーへの接続に必要な追加プロパティを、セミコロンで区切ったリスト形式で指定します。SSOLoginURL と一緒に使用します。

SSO 設定については、 で詳しく説明します。

追加のOAuth ステート情報を表すオプションの値。

The STSURL property defines the endpoint of the security token service (STS) used during SSO authentication. In most cases, the 本製品 automatically determines the correct STS URL, and this property does not need to be set.

This property may only be necessary in advanced or custom SSO configurations where the default discovery process does not resolve the correct STS endpoint.

This property is useful for troubleshooting or custom setups where the security token service URL must be specified manually to complete the authentication flow.

Additional Information

データベースによっては、利用可能なすべてのテーブルをリストするのに時間がかかり、パフォーマンスが低下する場合があります。 接続文字列にテーブルのリストを指定することで、時間を節約しパフォーマンスを向上させることができます。

利用可能なテーブルがたくさんあり、すでに作業したいテーブルが決まっている場合、このプロパティを使用して対象のテーブルのみに表示を制限することができます。これを行うには、カンマ区切りのリストで使用したいテーブルを指定します。各テーブルは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。 例えば、Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space` です。

Note：複数のスキーマまたはカタログを持つデータソースに接続する場合は、表示する各テーブルを完全修飾名で指定する必要があります。これにより、複数のカタログやスキーマに存在するテーブルが混同されることを防ぎます。

このプロパティは、本製品 が操作をキャンセルする前に操作の完了を待機する最大時間を秒単位で制御します。 操作の完了前にタイムアウト時間が経過すると、本製品 は操作をキャンセルして例外をスローします。

タイムアウトは、クエリや操作全体ではなくサーバーとの個々の通信に適用されます。 例えば、各ページング呼び出しがタイムアウト制限内に完了する場合、クエリはタイムアウトの値を超えて実行を続けることができます。

このプロパティを0に設定するとタイムアウトが無効になり、操作が成功するか、サーバー側のタイムアウト、ネットワークの中断、またはサーバーのリソース制限などの他の条件で失敗するまで無期限に実行されます。 このプロパティは慎重に使用してください。長時間実行される操作がパフォーマンスを低下させたり、応答しなくなる可能性があるためです。

URL プロパティは、本製品 が接続するMicrosoft SharePoint サイトのベースエンドポイントを定義します。これには、リストやライブラリの取得、テーブルに対するCRUD 操作の実行、ストアドプロシージャの実行などが含まれます。これらはすべて、URL で定義されたサイトに関連します。有効な値の例としては、以下のようなものがあります。

• http://server/SharePoint/
• http://server/Sites/mysite/
• http://server:90/
• https://contoso.sharepoint.com/
• https://contoso.sharepoint.com/sites/MySite/
• https://contoso.sharepoint.com/SubSite/

末尾のスラッシュは任意です。URL が、本製品 がクエリや操作に使用するルートサイトまたはサイトコレクションを指していることを確認してください。

このプロパティは、頻繁な接続作成に関連するオーバーヘッドを削減し、接続の使用率が高いアプリケーションのパフォーマンスを向上させます。 接続プーリングが有効な場合、アプリケーションは各接続が不要になったら明示的に閉じる必要があります。 接続を閉じると、物理的に終了するのではなく、再利用できるようにプールに戻ります。 接続がPoolIdleTimeout 時間を超えてアイドル状態になると、本製品 は自動的に接続を閉じてリソースを解放します。

デフォルトでは、接続プーリングは無効になっています。追加のプロパティ（PoolMaxSize、PoolIdleTimeout、PoolWaitTime など）を使用すると、接続プールの動作をカスタマイズできます。 これらの設定は、プールサイズ、アイドル接続タイムアウト、および接続が利用可能になるまでの待機時間の細かい調整を可能にします。 接続プールの使用に関する詳細は、接続プール を参照してください。

The UseDisplayNames property determines how column names are presented in metadata and query results.

When set to true, the 本製品 uses the display names shown in the Microsoft SharePoint UI, making queries and results more user-friendly and readable.

When set to false, the 本製品 uses the internal API names for columns, which may be less descriptive but more consistent for programmatic use.

This property applies to both the SOAP and REST schemas and is useful for aligning result sets with familiar column labels seen in the Microsoft SharePoint interface or for simplifying integration with external applications that rely on known display names.

Additional Information

Using display names can improve readability, but may introduce slight overhead during metadata retrieval, as display names must be resolved and mapped from API names. Using API names can streamline metadata processing and reduce complexity in environments where consistent field naming is preferred.

The UseEntityTypeName property determines whether the 本製品 uses the EntityTypeName of a Microsoft SharePoint list as the table name when retrieving metadata.

When set to true, the 本製品 uses the list’s EntityTypeName, which can provide more consistent, API-friendly names for tables.

When set to false, the 本製品 uses the list’s Title field as the table name, matching the name displayed in the Microsoft SharePoint UI.

This property applies only to the REST schema and is useful for ensuring consistent, stable naming in queries and integrations, especially when list titles are subject to change.

Additional Information

Using EntityTypeName can improve long-term stability of queries and integrations by avoiding table name changes caused by edits to list titles. However, display names may be more intuitive for end users. Switching between the two may require query updates or metadata refreshes.

This property determines which version of the NTLM authentication protocol the 本製品 uses when connecting.

When set to true, the 本製品 attempts to connect using NTLMv1, an older and less secure version of the protocol.

When set to false, the 本製品 uses NTLMv2, which is more secure and recommended for all environments.

This property is useful for compatibility with legacy systems that only support NTLMv1, though its use is discouraged in modern deployments.

Performance Considerations

Using NTLMv1 may expose connections to security vulnerabilities and is generally slower and less efficient than NTLMv2. NTLMv2 provides stronger authentication and improved performance. Only enable NTLMv1 when required for compatibility with older servers.

User プロパティはPassword プロパティと共に使用され、Microsoft SharePoint サーバーに対して認証を行います。

Microsoft SharePoint オンプレミスの場合、ユーザー名には次の形式でドメインを含める必要があります：DOMAIN\Username

Microsoft SharePoint オンラインの場合、ユーザー名は通常次のような形式となります：username@domain.onmicrosoft.com

このプロパティを使用すると、UserDefinedViews.json というJSON 形式の構成ファイルを通じてカスタムビューを定義および管理できます。 これらのビューは本製品 によって自動的に認識され、標準のデータベースビューのようにカスタムSQL クエリを実行できるようになります。 JSON ファイルは、各ビューをルート要素として定義し、その子要素として"query" を持ちます。この"query" にはビューのSQL クエリが含まれています。次に例を示します。

{
	"MyView": {
		"query": "SELECT * FROM Calendar WHERE MyColumn = 'value'"
	},
	"MyView2": {
		"query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
	}
}

このプロパティを使用して、1つのファイルに複数のビューを定義し、ファイルパスを指定できます。 例：UserDefinedViews=C:\Path\To\UserDefinedViews.json。 このプロパティを使用すると、指定されたビューのみが本製品 によって検知されます。

詳しくは、ユーザー定義ビュー を参照してください。

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

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

Notes：

• 英数字以外の文字はアンダースコアに変換されます。
• カラム名やテーブル名が128 文字を超える場合は、SQL Server 標準に準拠するために128文字に切り詰められます。

このプロパティは、本製品 がログファイルに含める詳細レベルを定義します。 Verbosity レベルを高くするとログに記録される情報の詳細が増えますが、ログファイルが大きくなり取り込まれるデータが増えるためパフォーマンスが低下する可能性があります。

デフォルトのVerbosity レベルは1で、通常の運用にはこれが推奨されます。 より高いVerbosity レベルは主にデバッグを目的としています。 各レベルの詳細については、ログ を参照してください。

LogModules プロパティと組み合わせることで、Verbosity は特定の情報カテゴリに対するログの詳細度を調整できます。

データベースによっては、利用可能なすべてのビューをリストするのに時間がかかり、パフォーマンスが低下する場合があります。 接続文字列にビューのリストを指定することで、時間を節約しパフォーマンスを向上させることができます。

利用可能なビューがたくさんあり、すでに作業したいビューが決まっている場合、このプロパティを使用して対象のビューのみに表示を制限することができます。これを行うには、カンマ区切りのリストで使用したいビューを指定します。各ビューは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。 例えば、Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space` です。

Note：複数のスキーマまたはカタログを持つデータソースに接続する場合は、確認する各ビューを完全修飾名で指定する必要があります。これにより、複数のカタログやスキーマに存在するビューが混同されることを防ぎます。