ConnectionPolicy クラス

public ConnectionPolicy()

コンストラクターです。

public ConnectionMode getConnectionMode()

クライアントで使用される接続モードを取得します。

戻り値:

public static ConnectionPolicy GetDefault()

既定の接続ポリシーを取得します。

戻り値:

public boolean getEnableEndpointDiscovery()

geo レプリケートされたデータベース アカウントのエンドポイント検出を有効にするフラグを取得します。

戻り値:

public int getIdleConnectionTimeoutInMillis()

アイドル状態の接続のタイムアウトの値を取得します。既定値は 60 秒です。

戻り値:

public int getMaxPoolSize()

クライアントが使用している接続プール サイズの値を取得します。

戻り値:

public MediaReadMode getMediaReadMode()

添付ファイルのコンテンツ (メディアとも呼ばれます) のダウンロード モードを取得します。

戻り値:

public int getMediaRequestTimeoutInMillis()

添付ファイル コンテンツ (メディア) 操作のネットワーク ピアからの応答を待機する時間を取得または設定します。

戻り値:

public List getPreferredLocations()

geo レプリケートされたデータベース アカウントの優先する場所を取得します

戻り値:

public InetSocketAddress getProxy()

プロキシ サーバーの InetSocketAddress を取得します。

戻り値:

public int getRequestTimeoutInMillis()

要求タイムアウト (ネットワーク ピアからの応答を待機する時間) をミリ秒単位で取得します。

戻り値:

public RetryOptions getRetryOptions()

DocumentClient インスタンスに関連付けられている再試行ポリシー オプションを取得します。

戻り値:

public String getUserAgentSuffix()

ユーザー エージェント サフィックスの値を取得します。

戻り値:

public Boolean isEnableReadRequestsFallback()

Azure Cosmos DB サービスのアカウントで構成された複数のリージョンへの読み取りを許可するかどうかを取得します。

既定値は null です。

このプロパティが設定されていない場合、境界付き制約以外のすべての整合性レベルの既定値は true、境界付き制約の既定値は false です。 1. enableEndpointDiscovery は true 2 です。 Azure Cosmos DB アカウントに複数のリージョンがある

戻り値:

public boolean isUsingMultipleWriteLocations()

Azure Cosmos DB サービス内の geo レプリケートされたデータベース アカウントの任意の場所 (リージョン) での書き込みを有効にするフラグを取得します。

このプロパティの値が true の場合、SDK は geo レプリケートされたデータベース アカウントの使用可能な書き込み可能な場所に書き込み操作を送信します。 書き込み可能な場所は、PreferredLocations プロパティによって並べ替えられます。 DatabaseAccount の EnableMultipleWriteLocations も true に設定されるまで、プロパティ値を true に設定しても効果はありません。

既定値は false で、書き込みリージョンの場合は PreferredLocations プロパティの最初のリージョンに、PreferredLocations が指定されていない場合はプライマリ アカウント リージョンに書き込みが送信されることを示します。

この値は、アカウント構成と一致している必要があります。

クライアントの有効期間中、書き込みでは、 で説明されているイベントの場合にリージョン エンドポイントを変更できます https://docs.microsoft.com/azure/cosmos-db/troubleshoot-sdk-availability

戻り値:

public void setConnectionMode(ConnectionMode connectionMode)

クライアントで使用される接続モードを設定します。

パラメーター:

public void setEnableEndpointDiscovery(boolean enableEndpointDiscovery)

geo レプリケートされたデータベース アカウントのエンドポイント検出を有効にするフラグを設定します。

EnableEndpointDiscovery が true の場合、SDK は現在の書き込みリージョンと読み取りリージョンを自動的に検出し、リージョンの機能とユーザーの設定に基づいて要求が正しいリージョンに送信されるようにします。

このプロパティの既定値は、エンドポイント検出が有効になっていることを示す true です。

パラメーター:

public void setEnableReadRequestsFallback(Boolean enableReadRequestsFallback)

Azure Cosmos DB サービスのアカウントで構成された複数のリージョンへの読み取りを許可するかどうかを設定します。

既定値は null です。

このプロパティが設定されていない場合、境界付き制約以外のすべての整合性レベルの既定値は true、境界付き制約の既定値は false です。 1. enableEndpointDiscovery は true 2 です。 Azure Cosmos DB アカウントに複数のリージョンがある

パラメーター:

public void setIdleConnectionTimeoutInMillis(int idleConnectionTimeoutInMillis)

は、アイドル状態の接続のタイムアウトの値を設定します。 その後、接続は自動的に閉じられます。

パラメーター:

public void setMaxPoolSize(int maxPoolSize)

接続プール サイズの値を設定します。既定値は 1000 です。

パラメーター:

public void setMediaReadMode(MediaReadMode mediaReadMode)

添付ファイルのコンテンツ (メディアとも呼ばれます) のダウンロード モードを設定します。

パラメーター:

public void setMediaRequestTimeoutInMillis(int mediaRequestTimeoutInMillis)

添付ファイル コンテンツ (メディア) 操作のネットワーク ピアからの応答を待機する時間を取得または設定します。

パラメーター:

public void setPreferredLocations(List preferredLocations)

geo レプリケートされたデータベース アカウントの優先する場所を設定します。 たとえば、優先する場所として "米国東部" とします。

EnableEndpointDiscovery が true で PreferredRegions が空でない場合、SDK では、操作を実行するために指定された順序でコレクション内の場所を使用します。

EnableEndpointDiscovery が false に設定されている場合、このプロパティは無視されます。

パラメーター:

public void setProxy(String proxyHost, int proxyPort)

これにより、プロキシ サーバーの InetSocketAddress が作成され、cosmosDB へのすべての要求がこのアドレスからルーティングされます。

パラメーター:

public void setRequestTimeoutInMillis(int requestTimeoutInMillis)

要求タイムアウト (ネットワーク ピアからの応答を待機する時間) をミリ秒単位で設定します。 既定値は 60 秒です。

パラメーター:

public void setRetryOptions(RetryOptions retryOptions)

DocumentClient インスタンスに関連付けられている再試行ポリシー オプションを設定します。

RetryOptions クラスのプロパティを使用すると、アプリケーションで組み込みの再試行ポリシーをカスタマイズできます。 このプロパティは省略可能です。 設定されていない場合、SDK は再試行ポリシーの構成に既定値を使用します。 詳細については、「RetryOptions クラス」を参照してください。

パラメーター:

public void setUserAgentSuffix(String userAgentSuffix)

は、ユーザー エージェント サフィックスの値を設定します。

パラメーター:

public void setUsingMultipleWriteLocations(boolean usingMultipleWriteLocations)

フラグを設定して、Azure Cosmos DB サービス内の geo レプリケートされたデータベース アカウントの任意の場所 (リージョン) に対する書き込みを有効にします。

このプロパティの値が true の場合、SDK は geo レプリケートされたデータベース アカウントの使用可能な書き込み可能な場所に書き込み操作を送信します。 書き込み可能な場所は、PreferredLocations プロパティによって並べ替えられます。 DatabaseAccount の EnableMultipleWriteLocations も true に設定されるまで、プロパティ値を true に設定しても効果はありません。

既定値は false で、書き込みリージョンの場合は PreferredLocations プロパティの最初のリージョンに、PreferredLocations が指定されていない場合はプライマリ アカウント リージョンに書き込みが送信されることを示します。

この値は、アカウント構成と一致している必要があります。

クライアントの有効期間中、書き込みでは、 で説明されているイベントの場合にリージョン エンドポイントを変更できます https://docs.microsoft.com/azure/cosmos-db/troubleshoot-sdk-availability

パラメーター:

public String toString()