CloudTable クラス

パッケージ:

com.microsoft.azure.storage.table

• java.lang.Object
• • com.microsoft.azure.storage.table.CloudTable

public class CloudTable

Microsoft Azure Table サービスのテーブルを表します。

コンストラクターの概要

コンストラクター	説明
CloudTable(final StorageUri uri)	指定したテーブル URI を使用して、 クラスのインスタンスを作成します。 テーブル URI には SAS トークンを含める必要があります。
CloudTable(final StorageUri uri, final StorageCredentials credentials)	指定したテーブル StorageUri と資格情報を使用して、 クラスのインスタンスを作成します。
CloudTable(final String tableName, final CloudTableClient client)	指定した名前とクライアントを使用して、 クラスのインスタンスを作成します。
CloudTable(final URI uri)	指定したテーブル URI を使用して、 クラスのインスタンスを作成します。 テーブル URI には SAS トークンを含める必要があります。
CloudTable(final URI uri, final StorageCredentials credentials)	指定したテーブル URI と資格情報を使用して、 クラスのインスタンスを作成します。

メソッドの概要

修飾子と型	メソッドと説明
void	create() 既定の要求オプションを使用して、ストレージ サービスにテーブルを作成します。 このメソッドは、 Create Table REST API を呼び出して、このインスタンスの Table service エンドポイントとストレージ アカウントの資格情報を使用して、指定されたテーブルを作成します。
void	create(TableRequestOptions options, OperationContext opContext) 指定した TableRequestOptions と OperationContextを使用して、ストレージ サービスにテーブルを作成します。 このメソッドは、 Create Table REST API を呼び出して、このインスタンスの Table service エンドポイントとストレージ アカウントの資格情報を使用して、指定されたテーブルを作成します。 操作の TableRequestOptions タイムアウトや再試行ポリシーなどの実行オプションをオーバーライドするには、 を使用します。
boolean	createIfNotExists() 既定の要求オプションが存在しない場合は、既定の要求オプションを使用してストレージ サービスにテーブルを作成します。
boolean	createIfNotExists(TableRequestOptions options, OperationContext opContext) 指定した要求オプションと操作コンテキストを使用して、ストレージ サービスにテーブルを作成します (まだ存在しない場合)。
void	delete() ストレージ サービスからテーブルを削除します。
void	delete(TableRequestOptions options, OperationContext opContext) 指定した要求オプションと操作コンテキストを使用して、ストレージ サービスからテーブルを削除します。
boolean	deleteIfExists() テーブルが存在する場合は、ストレージ サービスから削除します。
boolean	deleteIfExists(TableRequestOptions options, OperationContext opContext) 指定した要求オプションと操作コンテキスト (存在する場合) を使用して、ストレージ サービスからテーブルを削除します。
TablePermissions	downloadPermissions() テーブルのアクセス許可設定をダウンロードします。
TablePermissions	downloadPermissions(TableRequestOptions options, OperationContext opContext) 指定した要求オプションと操作コンテキストを使用して、テーブルのアクセス許可設定をダウンロードします。
ArrayList<TableResult>	execute(final TableBatchOperation batch) テーブルに対して指定されたバッチ操作をアトミック操作として実行します。 バッチ操作には、最大 100 個の個別のテーブル操作を含めることができます。各操作のエンティティには、同じパーティション キーが必要です。 バッチごとに許可される取得操作は 1 つだけです。 バッチ操作の合計ペイロードは、4 MB に制限されています。 このメソッドは、REST API で エンティティ グループ トランザクション を呼び出し、このインスタンスの Table Service エンドポイントとストレージ アカウントの資格情報を使用して、テーブルに対して指定されたバッチ操作をアトミック ユニットとして実行します。
ArrayList<TableResult>	execute(final TableBatchOperation batch, TableRequestOptions options, OperationContext opContext) 指定した と OperationContextを使用して、指定したバッチ操作をアトミック操作としてテーブルに対して実行しますTableRequestOptions。 バッチ操作には、最大 100 個の個別のテーブル操作を含めることができます。各操作のエンティティには、同じパーティション キーが必要です。 バッチごとに許可される取得操作は 1 つだけです。 バッチ操作の合計ペイロードは、4 MB に制限されています。 このメソッドは、REST API で エンティティ グループ トランザクション を呼び出し、このインスタンスの Table Service エンドポイントとストレージ アカウントの資格情報を使用して、テーブルに対して指定されたバッチ操作をアトミック ユニットとして実行します。 を TableRequestOptions 使用して、操作のタイムアウトや再試行ポリシーなどの実行オプションをオーバーライドします。
TableResult	execute(final TableOperation operation) テーブルに対する操作を実行します。 このメソッドは Table Service REST API を呼び出し、このインスタンスの Table Service エンドポイントとストレージ アカウントの資格情報を使用して、テーブルに対して指定された操作を実行します。
TableResult	execute(final TableOperation operation, final TableRequestOptions options, final OperationContext opContext) 指定された TableRequestOptions と OperationContext を使用してテーブルに対する操作を実行します。 このメソッドは Table Service REST API を呼び出し、このインスタンスの Table Service エンドポイントとストレージ アカウントの資格情報を使用して、テーブルに対して指定された操作を実行します。 を TableRequestOptions 使用して、操作のタイムアウトや再試行ポリシーなどの実行オプションをオーバーライドします。
<R> Iterable<R>	execute(final TableQuery<?> query, final EntityResolver<R> resolver) 指定した EntityResolver<T> を結果に適用して、クエリを実行します。 このメソッドは、このインスタンスの Table Service エンドポイントとストレージ アカウントの資格情報を使用して、Table Service REST API でクエリ エンティティ操作を呼び出してテーブルに対してクエリを実行します。
<R> Iterable<R>	execute(final TableQuery<?> query, final EntityResolver<R> resolver, final TableRequestOptions options, final OperationContext opContext) 指定した と OperationContextを使用して、指定した EntityResolver<T> を結果に適用してクエリを実行しますTableRequestOptions。 このメソッドは、このインスタンスの Table Service エンドポイントとストレージ アカウントの資格情報を使用して、Table Service REST API でクエリ エンティティ操作を呼び出してテーブルに対してクエリを実行します。 を TableRequestOptions 使用して、操作のタイムアウトや再試行ポリシーなどの実行オプションをオーバーライドします。
<T extends TableEntity> Iterable<T>	execute(final TableQuery<T> query) クエリを実行します。 このメソッドは、このインスタンスの Table Service エンドポイントとストレージ アカウントの資格情報を使用して、Table Service REST API でクエリ エンティティ操作を呼び出してテーブルに対してクエリを実行します。
<T extends TableEntity> Iterable<T>	execute(final TableQuery<T> query, final TableRequestOptions options, final OperationContext opContext) 指定した TableRequestOptions と OperationContextを使用してクエリを実行します。 このメソッドは、このインスタンスの Table Service エンドポイントとストレージ アカウントの資格情報を使用して、Table Service REST API でクエリ エンティティ操作を呼び出してテーブルに対してクエリを実行します。 を TableRequestOptions 使用して、操作のタイムアウトや再試行ポリシーなどの実行オプションをオーバーライドします。
<R> ResultSegment<R>	executeSegmented(final TableQuery<?> query, final EntityResolver<R> resolver, final ResultContinuation continuationToken) 指定した ResultContinuation 継続トークンを使用してセグメント化モードでクエリを実行し、 を EntityResolver<T> 結果に適用します。 を使用してクエリを実行すると、オブジェクト内のサーバーから返された情報を使用して、部分的な結果を返した後にクエリを ResultSegment<T> 再開できます。 このメソッドは、このインスタンスの Table Service エンドポイントとストレージ アカウントの資格情報を使用して、Table Service REST API でクエリ エンティティ操作を呼び出してテーブルに対してクエリを実行します。
<R> ResultSegment<R>	executeSegmented(final TableQuery<?> query, final EntityResolver<R> resolver, final ResultContinuation continuationToken, final TableRequestOptions options, final OperationContext opContext) 指定した と を使用して、指定したResultContinuation継続トークンを使用してTableRequestOptionsセグメント化モードでクエリを実行しOperationContextEntityResolver<T>、結果に を適用します。 を使用してクエリを実行すると、オブジェクト内のサーバーから返された情報を使用して、部分的な結果を返した後にクエリを ResultSegment<T> 再開できます。 このメソッドは、このインスタンスの Table Service エンドポイントとストレージ アカウントの資格情報を使用して、Table Service REST API でクエリ エンティティ操作を呼び出してテーブルに対してクエリを実行します。 を TableRequestOptions 使用して、操作のタイムアウトや再試行ポリシーなどの実行オプションをオーバーライドします。
<T extends TableEntity> ResultSegment<T>	executeSegmented(final TableQuery<T> query, final ResultContinuation continuationToken) 継続トークンを使用して、セグメント化モードでクエリを ResultContinuation 実行します。 を使用してクエリを実行すると、オブジェクト内のサーバーから返された情報を使用して、部分的な結果を返した後にクエリを ResultSegment<T> 再開できます。 このメソッドは、このインスタンスの Table Service エンドポイントとストレージ アカウントの資格情報を使用して、Table Service REST API でクエリ エンティティ操作を呼び出してテーブルに対してクエリを実行します。
<T extends TableEntity> ResultSegment<T>	executeSegmented(final TableQuery<T> query, final ResultContinuation continuationToken, final TableRequestOptions options, final OperationContext opContext) 指定した TableRequestOptions と OperationContextを使用して、継続トークンをResultContinuation使用してセグメント化モードでクエリを実行します。 を使用してクエリを実行すると、オブジェクト内のサーバーから返された情報を使用して、部分的な結果を返した後にクエリを ResultSegment<T> 再開できます。 このメソッドは、このインスタンスの Table Service エンドポイントとストレージ アカウントの資格情報を使用して、Table Service REST API でクエリ エンティティ操作を呼び出してテーブルに対してクエリを実行します。 を TableRequestOptions 使用して、操作のタイムアウトや再試行ポリシーなどの実行オプションをオーバーライドします。
boolean	exists() テーブルがストレージ サービスに存在するかどうかを示す値を返します。
boolean	exists(TableRequestOptions options, OperationContext opContext) 指定した要求オプションと操作コンテキストを使用して、テーブルがストレージ サービスに存在するかどうかを示す値を返します。
String	generateSharedAccessSignature(final SharedAccessTablePolicy policy, final String accessPolicyIdentifier, final String startPartitionKey, final String startRowKey, final String endPartitionKey, final String endRowKey) テーブルの共有アクセス署名を作成します。
String	generateSharedAccessSignature(final SharedAccessTablePolicy policy, final String accessPolicyIdentifier, final String startPartitionKey, final String startRowKey, final String endPartitionKey, final String endRowKey, final IPRange ipRange, final SharedAccessProtocols protocols) テーブルの共有アクセス署名を作成します。
String	getName() テーブルの名前を取得します。
CloudTableClient	getServiceClient() このキューに関連付けられているテーブル サービス クライアントを取得します。
final StorageUri	getStorageUri() すべての場所の URI の一覧を返します。
URI	getUri() このテーブルの絶対 URI を取得します。
void	uploadPermissions(final TablePermissions permissions) テーブルのアクセス許可をアップロードします。
void	uploadPermissions(final TablePermissions permissions, TableRequestOptions options, OperationContext opContext) 指定した要求オプションと操作コンテキストを使用して、テーブルのアクセス許可をアップロードします。

コンストラクターの詳細

CloudTable

public CloudTable(final StorageUri uri)

指定したテーブル URI を使用して、 クラスのインスタンスを作成します。 テーブル URI には SAS トークンを含める必要があります。

Parameters:

uri - StorageUriテーブルの絶対 URI を表す オブジェクト。

Throws:

StorageException - ストレージ サービス エラーが発生した場合。

CloudTable

public CloudTable(final StorageUri uri, final StorageCredentials credentials)

指定したテーブル StorageUri と資格情報を使用して、 クラスのインスタンスを作成します。

Parameters:

uri - StorageUriテーブルの絶対 StorageUri を表す オブジェクト。

credentials - StorageCredentialsアクセスを認証するために使用される オブジェクト。

Throws:

StorageException - ストレージ サービス エラーが発生した場合。

CloudTable

protected CloudTable(final String tableName, final CloudTableClient client)

指定した名前とクライアントを使用して、 クラスのインスタンスを作成します。

Parameters:

tableName - Stringテーブルの名前を表す 。テーブルの名前付け規則に従う必要があります。 テーブル名には、パス区切り文字 (/) を含めないようにしてください。 テーブル名では大文字と小文字が区別されず、アカウント内で一意である必要があり、3 から 63 文字の長さにする必要があります。 テーブル名は、 で始まる必要があります。数字で始めることはできません。英数字のみを含めることができます。 "table" など、一部のテーブル名は予約されています。

client - CloudTableClient関連付けられたサービス クライアントを表し、Table service のエンドポイントを指定する オブジェクト。

Throws:

URISyntaxException - tableName に基づいて構築されたリソース URI が無効な場合。

StorageException - ストレージ サービス エラーが発生した場合。

CloudTable

public CloudTable(final URI uri)

指定したテーブル URI を使用して、 クラスのインスタンスを作成します。 テーブル URI には SAS トークンを含める必要があります。

Parameters:

uri - java.net.URIテーブルの絶対 URI を表す オブジェクト。

Throws:

StorageException - ストレージ サービス エラーが発生した場合。

CloudTable

public CloudTable(final URI uri, final StorageCredentials credentials)

指定したテーブル URI と資格情報を使用して、 クラスのインスタンスを作成します。

Parameters:

uri - java.net.URIテーブルの絶対 URI を表す オブジェクト。

credentials - StorageCredentialsアクセスを認証するために使用される オブジェクト。

Throws:

StorageException - ストレージ サービス エラーが発生した場合。

メソッドの詳細

create

public void create()

既定の要求オプションを使用して、ストレージ サービスにテーブルを作成します。

このメソッドは、 Create Table REST API を呼び出して、このインスタンスの Table service エンドポイントとストレージ アカウントの資格情報を使用して、指定されたテーブルを作成します。

Throws:

StorageException - 操作中にストレージ サービス エラーが発生した場合。

create

public void create(TableRequestOptions options, OperationContext opContext)

指定した TableRequestOptions と OperationContextを使用して、ストレージ サービスにテーブルを作成します。

このメソッドは、 Create Table REST API を呼び出して、このインスタンスの Table service エンドポイントとストレージ アカウントの資格情報を使用して、指定されたテーブルを作成します。

操作の TableRequestOptions タイムアウトや再試行ポリシーなどの実行オプションをオーバーライドするには、 を使用します。

Parameters:

options - TableRequestOptions操作の再試行ポリシーやタイムアウト設定などの実行オプションを指定する オブジェクト。 で指定 null された要求オプションを使用するように を指定します CloudTableClient。

opContext - 現在の操作を追跡するための OperationContext オブジェクトです。 操作コンテキストを安全に無視するように を指定 null します。

Throws:

StorageException - ストレージ サービスへのアクセス中にエラーが発生した場合、またはテーブルを作成できない、または既に存在する場合。

createIfNotExists

public boolean createIfNotExists()

既定の要求オプションが存在しない場合は、既定の要求オプションを使用してストレージ サービスにテーブルを作成します。

Returns:

true テーブルがストレージ サービスで作成される場合は 。それ以外の場合 falseは 。

Throws:

StorageException - 操作中にストレージ サービス エラーが発生した場合。

createIfNotExists

public boolean createIfNotExists(TableRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して、ストレージ サービスにテーブルを作成します (まだ存在しない場合)。

Parameters:

options - TableRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられているサービス クライアント ( CloudTableClient) からの既定の要求オプションが使用されます。

opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Returns:

true テーブルがまだ存在せず、作成された場合は 。それ以外の場合 false は 。

Throws:

StorageException - 操作中にストレージ サービス エラーが発生した場合。

delete

public void delete()

ストレージ サービスからテーブルを削除します。

Throws:

StorageException - 操作中にストレージ サービス エラーが発生した場合。

delete

public void delete(TableRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して、ストレージ サービスからテーブルを削除します。

Parameters:

options - TableRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられているサービス クライアント ( CloudTableClient) からの既定の要求オプションが使用されます。

opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Throws:

StorageException - 操作中にストレージ サービス エラーが発生した場合。

deleteIfExists

public boolean deleteIfExists()

テーブルが存在する場合は、ストレージ サービスから削除します。

Returns:

true テーブルがストレージ サービスに存在し、削除されている場合は 。それ以外の場合 falseは 。

Throws:

StorageException - 操作中にストレージ サービス エラーが発生した場合。

deleteIfExists

public boolean deleteIfExists(TableRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキスト (存在する場合) を使用して、ストレージ サービスからテーブルを削除します。

Parameters:

options - TableRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられたサービス クライアント ( CloudTableClient) からの既定の要求オプションが使用されます。

opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Returns:

テーブルがストレージ サービスに存在し、削除されている場合は の値 true 。それ以外の場合 falseは 。

Throws:

StorageException - 操作中にストレージ サービス エラーが発生した場合。

downloadPermissions

public TablePermissions downloadPermissions()

テーブルのアクセス許可設定をダウンロードします。

Returns:

TablePermissionsコンテナーのアクセス許可を表す オブジェクト。

Throws:

StorageException - ストレージ サービス エラーが発生した場合。

downloadPermissions

public TablePermissions downloadPermissions(TableRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して、テーブルのアクセス許可設定をダウンロードします。

Parameters:

options - TableRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられたサービス クライアント ( CloudTableClient) からの既定の要求オプションが使用されます。

opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Returns:

TablePermissionsテーブルのアクセス許可を表す オブジェクト。

Throws:

StorageException - ストレージ サービス エラーが発生した場合。

execute

public ArrayList execute(final TableBatchOperation batch)

テーブルに対して指定されたバッチ操作をアトミック操作として実行します。 バッチ操作には、最大 100 個の個別のテーブル操作を含めることができます。各操作のエンティティには、同じパーティション キーが必要です。 バッチごとに許可される取得操作は 1 つだけです。 バッチ操作の合計ペイロードは、4 MB に制限されています。

このメソッドは、REST API で エンティティ グループ トランザクション を呼び出し、このインスタンスの Table Service エンドポイントとストレージ アカウントの資格情報を使用して、テーブルに対して指定されたバッチ操作をアトミック ユニットとして実行します。

Parameters:

batch - テーブルに対して実行する操作を表す TableBatchOperation オブジェクトです。

Returns:

java.util.ArrayListTableResult名前付きテーブルの 内のそれぞれのTableOperationTableBatchOperation結果を順番に格納する の 。

Throws:

StorageException - ストレージ サービスへのアクセスでエラーが発生した場合、または操作が失敗した場合は 。

execute

public ArrayList execute(final TableBatchOperation batch, TableRequestOptions options, OperationContext opContext)

指定した と OperationContextを使用して、指定したバッチ操作をアトミック操作としてテーブルに対して実行しますTableRequestOptions。 バッチ操作には、最大 100 個の個別のテーブル操作を含めることができます。各操作のエンティティには、同じパーティション キーが必要です。 バッチごとに許可される取得操作は 1 つだけです。 バッチ操作の合計ペイロードは、4 MB に制限されています。

このメソッドは、REST API で エンティティ グループ トランザクション を呼び出し、このインスタンスの Table Service エンドポイントとストレージ アカウントの資格情報を使用して、テーブルに対して指定されたバッチ操作をアトミック ユニットとして実行します。

を TableRequestOptions 使用して、操作のタイムアウトや再試行ポリシーなどの実行オプションをオーバーライドします。

Parameters:

batch - テーブルに対して実行する操作を表す TableBatchOperation オブジェクトです。

options - TableRequestOptions操作の再試行ポリシーやタイムアウト設定などの実行オプションを指定する オブジェクト。 で指定された要求オプションを使用するように を指定 null します CloudTableClient。

opContext - 現在の操作を追跡するための OperationContext オブジェクトです。 操作コンテキストを安全に無視するように を指定 null します。

Returns:

java.util.ArrayListTableResult名前付きテーブルの 内のそれぞれのTableOperationTableBatchOperation結果を順番に格納する の 。

Throws:

StorageException - ストレージ サービスへのアクセスでエラーが発生した場合、または操作が失敗した場合は 。

execute

public TableResult execute(final TableOperation operation)

テーブルに対する操作を実行します。

このメソッドは Table Service REST API を呼び出し、このインスタンスの Table Service エンドポイントとストレージ アカウントの資格情報を使用して、テーブルに対して指定された操作を実行します。

Parameters:

operation - TableOperationテーブルで実行する操作を表す オブジェクト。

Returns:

TableResultテーブルで を実行した結果をTableOperation格納している 。

Throws:

StorageException - ストレージ サービスへのアクセスでエラーが発生した場合、または操作が失敗した場合は 。

execute

public TableResult execute(final TableOperation operation, final TableRequestOptions options, final OperationContext opContext)

指定された TableRequestOptions と OperationContext を使用してテーブルに対する操作を実行します。

このメソッドは Table Service REST API を呼び出し、このインスタンスの Table Service エンドポイントとストレージ アカウントの資格情報を使用して、テーブルに対して指定された操作を実行します。

を TableRequestOptions 使用して、操作のタイムアウトや再試行ポリシーなどの実行オプションをオーバーライドします。

Parameters:

operation - TableOperationテーブルで実行する操作を表す オブジェクト。

options - TableRequestOptions操作の再試行ポリシーやタイムアウト設定などの実行オプションを指定する オブジェクト。 で指定された要求オプションを使用するように を指定 null します CloudTableClient。

opContext - 現在の操作を追跡するための OperationContext オブジェクトです。 操作コンテキストを安全に無視するように を指定 null します。

Returns:

TableResultテーブルで を実行した結果をTableOperation格納している 。

Throws:

StorageException - ストレージ サービスへのアクセスでエラーが発生した場合、または操作が失敗した場合は 。

execute

public Iterable execute(final TableQuery query, final EntityResolver resolver)

指定した EntityResolver<T> を結果に適用して、クエリを実行します。

このメソッドは、このインスタンスの Table Service エンドポイントとストレージ アカウントの資格情報を使用して、Table Service REST API でクエリ エンティティ操作を呼び出してテーブルに対してクエリを実行します。

Parameters:

query - TableQuery<T>クエリを実行するテーブルと使用するクエリ パラメーターを指定するインスタンス。

resolver - 指定された型 R に対してテーブルのクエリ結果エンティティを射影する EntityResolver<T> インスタンスです。

Returns:

クエリを実行した Iterable 結果の型 R へのプロジェクションを含むインターフェイスを実装するコレクション。

execute

public Iterable execute(final TableQuery query, final EntityResolver resolver, final TableRequestOptions options, final OperationContext opContext)

指定した と OperationContextを使用して、指定した EntityResolver<T> を結果に適用してクエリを実行しますTableRequestOptions。

このメソッドは、このインスタンスの Table Service エンドポイントとストレージ アカウントの資格情報を使用して、Table Service REST API でクエリ エンティティ操作を呼び出してテーブルに対してクエリを実行します。

を TableRequestOptions 使用して、操作のタイムアウトや再試行ポリシーなどの実行オプションをオーバーライドします。

Parameters:

query - TableQuery<T>クエリを実行するテーブルと使用するクエリ パラメーターを指定するインスタンス。

resolver - 指定された型 R に対してテーブルのクエリ結果エンティティを射影する EntityResolver<T> インスタンスです。

options - TableRequestOptions操作の再試行ポリシーやタイムアウト設定などの実行オプションを指定する オブジェクト。 で指定された要求オプションを使用するように を指定 null します CloudTableClient。

opContext - 現在の操作を追跡するための OperationContext オブジェクトです。 操作コンテキストを安全に無視するように を指定 null します。

Returns:

クエリを実行した Iterable 結果の型 R へのプロジェクションを含むインターフェイスを実装するコレクション。

execute

public Iterable execute(final TableQuery query)

クエリを実行します。

このメソッドは、このインスタンスの Table Service エンドポイントとストレージ アカウントの資格情報を使用して、Table Service REST API でクエリ エンティティ操作を呼び出してテーブルに対してクエリを実行します。

Parameters:

query - TableQuery<T>クエリを実行するテーブルと使用するクエリ パラメーターを指定するインスタンス。型 T に特化して を実装TableEntityします。

Returns:

クエリを実行した結果の Iterable 型 T に特化したインターフェイスを実装するコレクション。

execute

public Iterable execute(final TableQuery query, final TableRequestOptions options, final OperationContext opContext)

指定した TableRequestOptions と OperationContextを使用してクエリを実行します。

このメソッドは、このインスタンスの Table Service エンドポイントとストレージ アカウントの資格情報を使用して、Table Service REST API でクエリ エンティティ操作を呼び出してテーブルに対してクエリを実行します。

を TableRequestOptions 使用して、操作のタイムアウトや再試行ポリシーなどの実行オプションをオーバーライドします。

Parameters:

query - TableQuery<T>クエリを実行するテーブルと使用するクエリ パラメーターを指定するインスタンス。型 T に特化して を実装TableEntityします。

options - TableRequestOptions操作の再試行ポリシーやタイムアウト設定などの実行オプションを指定する オブジェクト。 で指定された要求オプションを使用するように を指定 null します CloudTableClient。

opContext - 現在の操作を追跡するための OperationContext オブジェクトです。 操作コンテキストを安全に無視するように を指定 null します。

Returns:

クエリを実行した結果の Iterable 型 T に特化したインターフェイスを実装するコレクション。

executeSegmented

public ResultSegment executeSegmented(final TableQuery query, final EntityResolver resolver, final ResultContinuation continuationToken)

指定した ResultContinuation 継続トークンを使用してセグメント化モードでクエリを実行し、 を EntityResolver<T> 結果に適用します。 を使用してクエリを実行すると、オブジェクト内のサーバーから返された情報を使用して、部分的な結果を返した後にクエリを ResultSegment<T> 再開できます。

このメソッドは、このインスタンスの Table Service エンドポイントとストレージ アカウントの資格情報を使用して、Table Service REST API でクエリ エンティティ操作を呼び出してテーブルに対してクエリを実行します。

Parameters:

query - TableQuery<T>クエリを実行するテーブルと使用するクエリ パラメーターを指定するインスタンス。

resolver - 指定された型 R に対してテーブルのクエリ結果エンティティを射影する EntityResolver<T> インスタンスです。

continuationToken - 操作の結果が部分的に返されたときにサーバーからの継続トークンを表す ResultContinuation オブジェクトです。 最初の呼び出しで を指定 null します。 結果の メソッドを getContinuationToken() 呼び出して、次の ResultContinuation 呼び出しで使用するオブジェクトを取得してクエリを再開します。

Returns:

R 型に射影したクエリの実行結果を含んだ ResultSegment<T> です。

Throws:

StorageException - 操作中にストレージ サービス エラーが発生した場合は 。

executeSegmented

public ResultSegment executeSegmented(final TableQuery query, final EntityResolver resolver, final ResultContinuation continuationToken, final TableRequestOptions options, final OperationContext opContext)

指定した と を使用して、指定したResultContinuation継続トークンを使用してTableRequestOptionsセグメント化モードでクエリを実行しOperationContextEntityResolver<T>、結果に を適用します。 を使用してクエリを実行すると、オブジェクト内のサーバーから返された情報を使用して、部分的な結果を返した後にクエリを ResultSegment<T> 再開できます。

このメソッドは、このインスタンスの Table Service エンドポイントとストレージ アカウントの資格情報を使用して、Table Service REST API でクエリ エンティティ操作を呼び出してテーブルに対してクエリを実行します。

を TableRequestOptions 使用して、操作のタイムアウトや再試行ポリシーなどの実行オプションをオーバーライドします。

Parameters:

query - TableQuery<T>クエリを実行するテーブルと使用するクエリ パラメーターを指定するインスタンス。

resolver - 指定された型 R に対してテーブルのクエリ結果エンティティを射影する EntityResolver<T> インスタンスです。

continuationToken - 操作の結果が部分的に返されたときにサーバーからの継続トークンを表す ResultContinuation オブジェクトです。 最初の呼び出しで を指定 null します。 結果の メソッドを getContinuationToken() 呼び出して、次の ResultContinuation 呼び出しで使用するオブジェクトを取得してクエリを再開します。

options - TableRequestOptions操作の再試行ポリシーやタイムアウト設定などの実行オプションを指定する オブジェクト。 で指定された要求オプションを使用するように を指定 null します CloudTableClient。

opContext - 現在の操作を追跡するための OperationContext オブジェクトです。 操作コンテキストを安全に無視するように を指定 null します。

Returns:

R 型に射影したクエリの実行結果を含んだ ResultSegment<T> です。

Throws:

StorageException - 操作中にストレージ サービス エラーが発生した場合は 。

executeSegmented

public ResultSegment executeSegmented(final TableQuery query, final ResultContinuation continuationToken)

継続トークンを使用して、セグメント化モードでクエリを ResultContinuation 実行します。 を使用してクエリを実行すると、オブジェクト内のサーバーから返された情報を使用して、部分的な結果を返した後にクエリを ResultSegment<T> 再開できます。

このメソッドは、このインスタンスの Table Service エンドポイントとストレージ アカウントの資格情報を使用して、Table Service REST API でクエリ エンティティ操作を呼び出してテーブルに対してクエリを実行します。

Parameters:

query - TableQuery<T>クエリを実行するテーブルと使用するクエリ パラメーターを指定するインスタンス。型 T に特化して を実装TableEntityします。

continuationToken - 操作の結果が部分的に返されたときにサーバーからの継続トークンを表す ResultContinuation オブジェクトです。 最初の呼び出しで を指定 null します。 結果の メソッドを getContinuationToken() 呼び出して、次の ResultContinuation 呼び出しで使用するオブジェクトを取得してクエリを再開します。

Returns:

ResultSegment<T>クエリを実行した結果の型 T に特化した 。

Throws:

StorageException - 操作中にストレージ サービス エラーが発生した場合は 。

executeSegmented

public ResultSegment executeSegmented(final TableQuery query, final ResultContinuation continuationToken, final TableRequestOptions options, final OperationContext opContext)

指定した TableRequestOptions と OperationContextを使用して、継続トークンをResultContinuation使用してセグメント化モードでクエリを実行します。 を使用してクエリを実行すると、オブジェクト内のサーバーから返された情報を使用して、部分的な結果を返した後にクエリを ResultSegment<T> 再開できます。

このメソッドは、このインスタンスの Table Service エンドポイントとストレージ アカウントの資格情報を使用して、Table Service REST API でクエリ エンティティ操作を呼び出してテーブルに対してクエリを実行します。

を TableRequestOptions 使用して、操作のタイムアウトや再試行ポリシーなどの実行オプションをオーバーライドします。

Parameters:

query - TableQuery<T>クエリを実行するテーブルと使用するクエリ パラメーターを指定するインスタンス。型 T に特化して を実装TableEntityします。

continuationToken - 操作の結果が部分的に返されたときにサーバーからの継続トークンを表す ResultContinuation オブジェクトです。 最初の呼び出しで を指定 null します。 結果の メソッドを getContinuationToken() 呼び出して、次の ResultContinuation 呼び出しで使用するオブジェクトを取得してクエリを再開します。

options - TableRequestOptions操作の再試行ポリシーやタイムアウト設定などの実行オプションを指定する オブジェクト。 で指定された要求オプションを使用するように を指定 null します CloudTableClient。

opContext - 現在の操作を追跡するための OperationContext オブジェクトです。 操作コンテキストを安全に無視するように を指定 null します。

Returns:

ResultSegment<T>クエリを実行した結果の型 T に特化した 。

Throws:

StorageException - 操作中にストレージ サービス エラーが発生した場合は 。

exists

public boolean exists()

テーブルがストレージ サービスに存在するかどうかを示す値を返します。

Returns:

true テーブルがストレージ サービスに存在する場合は 。それ以外の場合 falseは 。

Throws:

StorageException - 操作中にストレージ サービス エラーが発生した場合。

exists

public boolean exists(TableRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して、テーブルがストレージ サービスに存在するかどうかを示す値を返します。

Parameters:

options - TableRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられたサービス クライアント ( CloudTableClient) からの既定の要求オプションが使用されます。

opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Returns:

true テーブルがストレージ サービスに存在する場合は 。それ以外の場合 falseは 。

Throws:

StorageException - 操作中にストレージ サービス エラーが発生した場合。

generateSharedAccessSignature

public String generateSharedAccessSignature(final SharedAccessTablePolicy policy, final String accessPolicyIdentifier, final String startPartitionKey, final String startRowKey, final String endPartitionKey, final String endRowKey)

テーブルの共有アクセス署名を作成します。

Parameters:

policy - SharedAccessTablePolicy共有アクセス署名のアクセス ポリシーを表す オブジェクト。

accessPolicyIdentifier - Stringテーブル レベルのアクセス ポリシーを表す 。

startPartitionKey - String開始パーティション キーを表す 。

startRowKey - String開始行キーを表す 。

endPartitionKey - String終了パーティション キーを表す 。

endRowKey - String終了キーを表す 。

Returns:

Stringテーブルの共有アクセス署名を含む 。

Throws:

InvalidKeyException - 無効なキーが渡された場合。

StorageException - ストレージ サービス エラーが発生した場合。

IllegalArgumentException - 予期しない値が渡された場合。

generateSharedAccessSignature

public String generateSharedAccessSignature(final SharedAccessTablePolicy policy, final String accessPolicyIdentifier, final String startPartitionKey, final String startRowKey, final String endPartitionKey, final String endRowKey, final IPRange ipRange, final SharedAccessProtocols protocols)

テーブルの共有アクセス署名を作成します。

Parameters:

policy - SharedAccessTablePolicy共有アクセス署名のアクセス ポリシーを表す オブジェクト。

accessPolicyIdentifier - Stringテーブル レベルのアクセス ポリシーを表す 。

startPartitionKey - String開始パーティション キーを表す 。

startRowKey - String開始行キーを表す 。

endPartitionKey - String終了パーティション キーを表す 。

endRowKey - String終了キーを表す 。

ipRange - IPRange許可される IP アドレスの範囲を含む オブジェクト。

protocols - SharedAccessProtocols許可されているインターネット プロトコルを表す 。

Returns:

Stringテーブルの共有アクセス署名を含む 。

Throws:

InvalidKeyException - 無効なキーが渡された場合。

StorageException - ストレージ サービス エラーが発生した場合。

IllegalArgumentException - 予期しない値が渡された場合。

getName

public String getName()

テーブルの名前を取得します。

Returns:

テーブルの String 名前を表す オブジェクト。

getServiceClient

public CloudTableClient getServiceClient()

このキューに関連付けられているテーブル サービス クライアントを取得します。

Returns:

CloudTableClientこのテーブルに関連付けられているサービス クライアントを表す オブジェクト。

getStorageUri

public final StorageUri getStorageUri()

すべての場所の URI の一覧を返します。

Returns:

StorageUriすべての場所の URI の一覧を表す 。

getUri

public URI getUri()

このテーブルの絶対 URI を取得します。

Returns:

java.net.URIこのテーブルの URI を表す オブジェクト。

uploadPermissions

public void uploadPermissions(final TablePermissions permissions)

テーブルのアクセス許可をアップロードします。

Parameters:

permissions - TablePermissionsアップロードするアクセス許可を表す オブジェクト。

Throws:

StorageException - ストレージ サービス エラーが発生した場合。

uploadPermissions

public void uploadPermissions(final TablePermissions permissions, TableRequestOptions options, OperationContext opContext)

指定した要求オプションと操作コンテキストを使用して、テーブルのアクセス許可をアップロードします。

Parameters:

permissions - TablePermissionsアップロードするアクセス許可を表す オブジェクト。

options - TableRequestOptions要求の追加オプションを指定する オブジェクト。 を null 指定すると、関連付けられたサービス クライアント ( CloudTableClient) からの既定の要求オプションが使用されます。

opContext - 現在の操作のコンテキストを表す OperationContext オブジェクトです。 このオブジェクトを使用して、ストレージ サービスへの要求を追跡したり、操作に関する追加のランタイム情報を渡したりします。

Throws:

StorageException - ストレージ サービス エラーが発生した場合。