你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

CloudTable 类

包:

com.microsoft.azure.storage.table

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

public class CloudTable

表示 Microsoft Azure 表服务中的表。

构造函数摘要

构造函数	说明
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() 使用默认请求选项在存储服务中创建表。 此方法调用 创建表 REST API，以使用此实例的表服务终结点和存储帐户凭据创建指定的表。
void	create(TableRequestOptions options, OperationContext opContext) 使用指定的 TableRequestOptions 和 OperationContext在存储服务中创建表。 此方法调用 创建表 REST API，以使用此实例的表服务终结点和存储帐户凭据创建指定的表。 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 个不同的表操作，但要求是每个操作实体必须具有相同的分区键。 每个批只允许一次检索操作。 请注意，批处理操作的总负载限制为 4MB。 此方法调用 REST API 上的 实体组事务 ，以使用此实例的表服务终结点和存储帐户凭据以原子单元的形式对表执行指定的批处理操作。
ArrayList<TableResult>	execute(final TableBatchOperation batch, TableRequestOptions options, OperationContext opContext) 使用指定的 和 OperationContext以原子操作的形式对表执行指定的TableRequestOptions批处理操作。 一个批处理操作最多可以包含 100 个不同的表操作，但要求是每个操作实体必须具有相同的分区键。 每个批只允许一次检索操作。 请注意，批处理操作的总负载限制为 4MB。 此方法调用 REST API 上的 实体组事务 ，以使用此实例的表服务终结点和存储帐户凭据以原子单元的形式对表执行指定的批处理操作。 TableRequestOptions使用 替代操作的超时或重试策略等执行选项。
TableResult	execute(final TableOperation operation) 对表执行操作。 此方法将调用 表服务 REST API ，以使用此实例的表服务终结点和存储帐户凭据对表执行指定的操作。
TableResult	execute(final TableOperation operation, final TableRequestOptions options, final OperationContext opContext) 使用指定的 TableRequestOptions 和 OperationContext 对表执行操作。 此方法将调用 表服务 REST API ，以使用此实例的表服务终结点和存储帐户凭据对表执行指定的操作。 TableRequestOptions使用 替代操作的超时或重试策略等执行选项。
<R> Iterable<R>	execute(final TableQuery<?> query, final EntityResolver<R> resolver) 执行查询，将指定的 EntityResolver<T> 应用于结果。 此方法将使用此实例的表服务终结点和存储帐户凭据调用表服务 REST API 上的查询实体操作来查询表。
<R> Iterable<R>	execute(final TableQuery<?> query, final EntityResolver<R> resolver, final TableRequestOptions options, final OperationContext opContext) 使用指定的 和 OperationContext执行查询，将指定的 EntityResolver<T>TableRequestOptions 应用于结果。 此方法将使用此实例的表服务终结点和存储帐户凭据调用表服务 REST API 上的查询实体操作来查询表。 TableRequestOptions使用 替代操作的超时或重试策略等执行选项。
<T extends TableEntity> Iterable<T>	execute(final TableQuery<T> query) 执行查询。 此方法将使用此实例的表服务终结点和存储帐户凭据调用表服务 REST API 上的查询实体操作来查询表。
<T extends TableEntity> Iterable<T>	execute(final TableQuery<T> query, final TableRequestOptions options, final OperationContext opContext) 使用指定的 TableRequestOptions 和 OperationContext执行查询。 此方法将使用此实例的表服务终结点和存储帐户凭据调用表服务 REST API 上的查询实体操作来查询表。 TableRequestOptions使用 替代操作的超时或重试策略等执行选项。
<R> ResultSegment<R>	executeSegmented(final TableQuery<?> query, final EntityResolver<R> resolver, final ResultContinuation continuationToken) 使用指定的 ResultContinuation 延续标记在分段模式下执行查询，并将 EntityResolver<T> 应用于结果。 使用 执行查询后，可以使用 服务器在 对象中 ResultSegment<T> 返回的信息，在返回部分结果后恢复查询。 此方法将使用此实例的表服务终结点和存储帐户凭据调用表服务 REST API 上的查询实体操作来查询表。
<R> ResultSegment<R>	executeSegmented(final TableQuery<?> query, final EntityResolver<R> resolver, final ResultContinuation continuationToken, final TableRequestOptions options, final OperationContext opContext) 使用TableRequestOptions指定的 和 OperationContext在分段模式下使用指定的ResultContinuation继续标记执行查询，并将 EntityResolver<T> 应用于结果。 使用 执行查询允许使用 对象中的 ResultSegment<T> 服务器返回的信息，在返回部分结果后恢复查询。 此方法将使用此实例的表服务终结点和存储帐户凭据调用表服务 REST API 上的查询实体操作来查询表。 TableRequestOptions使用 替代操作的超时或重试策略等执行选项。
<T extends TableEntity> ResultSegment<T>	executeSegmented(final TableQuery<T> query, final ResultContinuation continuationToken) 使用 ResultContinuation 延续标记在分段模式下执行查询。 使用 执行查询允许使用 对象中的 ResultSegment<T> 服务器返回的信息，在返回部分结果后恢复查询。 此方法将使用此实例的表服务终结点和存储帐户凭据调用表服务 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> 服务器返回的信息，在返回部分结果后恢复查询。 此方法将使用此实例的表服务终结点和存储帐户凭据调用表服务 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 对象，该对象表示关联的服务客户端，并指定表服务的终结点。

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()

使用默认请求选项在存储服务中创建表。

此方法调用 创建表 REST API，以使用此实例的表服务终结点和存储帐户凭据创建指定的表。

Throws:

StorageException - 如果在操作期间发生存储服务错误。

create

public void create(TableRequestOptions options, OperationContext opContext)

使用指定的 TableRequestOptions 和 OperationContext在存储服务中创建表。

此方法调用 创建表 REST API，以使用此实例的表服务终结点和存储帐户凭据创建指定的表。

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 个不同的表操作，但要求是每个操作实体必须具有相同的分区键。 每个批只允许一次检索操作。 请注意，批处理操作的总负载限制为 4MB。

此方法调用 REST API 上的 实体组事务 ，以使用此实例的表服务终结点和存储帐户凭据以原子单元的形式对表执行指定的批处理操作。

Parameters:

batch - 表示要对表执行的操作的 TableBatchOperation 对象。

Returns:

的 ，java.util.ArrayList它按顺序包含命名表上的 中TableBatchOperation每个TableOperation的结果。TableResult

Throws:

StorageException - 如果访问存储服务时出错，或者操作失败。

execute

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

使用指定的 和 OperationContext以原子操作的形式对表执行指定的TableRequestOptions批处理操作。 一个批处理操作最多可以包含 100 个不同的表操作，但要求是每个操作实体必须具有相同的分区键。 每个批只允许一次检索操作。 请注意，批处理操作的总负载限制为 4MB。

此方法调用 REST API 上的 实体组事务 ，以使用此实例的表服务终结点和存储帐户凭据以原子单元的形式对表执行指定的批处理操作。

TableRequestOptions使用 替代操作的超时或重试策略等执行选项。

Parameters:

batch - 表示要对表执行的操作的 TableBatchOperation 对象。

options - 一个 TableRequestOptions 对象，该对象指定执行选项，例如操作的重试策略和超时设置。 指定 null 以使用 上 CloudTableClient指定的请求选项。

opContext - 用于跟踪当前操作的 OperationContext 对象。 指定 null 以安全地忽略操作上下文。

Returns:

的 ，java.util.ArrayList它按顺序包含命名表上的 中TableBatchOperation每个TableOperation的结果。TableResult

Throws:

StorageException - 如果访问存储服务时出错，或者操作失败。

execute

public TableResult execute(final TableOperation operation)

对表执行操作。

此方法将调用 表服务 REST API ，以使用此实例的表服务终结点和存储帐户凭据对表执行指定的操作。

Parameters:

operation - 表示 TableOperation 要对表执行的操作的 对象。

Returns:

一个 TableResult ，包含对表执行 的结果 TableOperation 。

Throws:

StorageException - 如果访问存储服务时出错，或者操作失败。

execute

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

使用指定的 TableRequestOptions 和 OperationContext 对表执行操作。

此方法将调用 表服务 REST API ，以使用此实例的表服务终结点和存储帐户凭据对表执行指定的操作。

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> 应用于结果。

此方法将使用此实例的表服务终结点和存储帐户凭据调用表服务 REST API 上的查询实体操作来查询表。

Parameters:

query - 指定要 TableQuery<T> 查询的表和要使用的查询参数的实例。

resolver - 一个 EntityResolver<T> 实例，用于创建从表查询结果实体到指定类型 R 的映射。

Returns:

一个实现 接口的集合， Iterable 该接口包含投影为执行查询的结果的类型 R 。

execute

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

使用指定的 和 OperationContext执行查询，将指定的 EntityResolver<T>TableRequestOptions 应用于结果。

此方法将使用此实例的表服务终结点和存储帐户凭据调用表服务 REST API 上的查询实体操作来查询表。

TableRequestOptions使用 替代操作的超时或重试策略等执行选项。

Parameters:

query - 指定要 TableQuery<T> 查询的表和要使用的查询参数的实例。

resolver - 一个 EntityResolver<T> 实例，用于创建从表查询结果实体到指定类型 R 的映射。

options - 一个 TableRequestOptions 对象，该对象指定执行选项，例如操作的重试策略和超时设置。 指定 null 以使用 上 CloudTableClient指定的请求选项。

opContext - 用于跟踪当前操作的 OperationContext 对象。 指定 null 以安全地忽略操作上下文。

Returns:

一个实现 接口的集合， Iterable 该接口包含投影为执行查询的结果的类型 R 。

execute

public Iterable execute(final TableQuery query)

执行查询。

此方法将使用此实例的表服务终结点和存储帐户凭据调用表服务 REST API 上的查询实体操作来查询表。

Parameters:

query - 一个 TableQuery<T> 实例，指定要查询的表和要使用的查询参数，专用于实现 的类型 TableEntityT。

Returns:

一个集合， Iterable 该集合实现专用于执行查询结果的类型 T 的接口。

execute

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

使用指定的 TableRequestOptions 和 OperationContext执行查询。

此方法将使用此实例的表服务终结点和存储帐户凭据调用表服务 REST API 上的查询实体操作来查询表。

TableRequestOptions使用 替代操作的超时或重试策略等执行选项。

Parameters:

query - 一个 TableQuery<T> 实例，指定要查询的表和要使用的查询参数，专用于实现 的类型 TableEntityT。

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> 返回的信息，在返回部分结果后恢复查询。

此方法将使用此实例的表服务终结点和存储帐户凭据调用表服务 REST API 上的查询实体操作来查询表。

Parameters:

query - 指定要 TableQuery<T> 查询的表和要使用的查询参数的实例。

resolver - 一个 EntityResolver<T> 实例，用于创建从表查询结果实体到指定类型 R 的映射。

continuationToken - 一个 ResultContinuation 对象，表示当操作返回部分结果时服务器中的继续标记。 在初始调用中指定 null 。 getContinuationToken()对结果调用 方法以获取ResultContinuation在下一次调用中使用的 对象，以恢复查询。

Returns:

一个 ResultSegment<T>，包含查询执行结果到类型 R 的映射。

Throws:

StorageException - 如果在操作期间发生存储服务错误，则为 。

executeSegmented

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

使用TableRequestOptions指定的 和 OperationContext在分段模式下使用指定的ResultContinuation继续标记执行查询，并将 EntityResolver<T> 应用于结果。 使用 执行查询允许使用 对象中的 ResultSegment<T> 服务器返回的信息，在返回部分结果后恢复查询。

此方法将使用此实例的表服务终结点和存储帐户凭据调用表服务 REST API 上的查询实体操作来查询表。

TableRequestOptions使用 替代操作的超时或重试策略等执行选项。

Parameters:

query - 指定要 TableQuery<T> 查询的表和要使用的查询参数的实例。

resolver - 一个 EntityResolver<T> 实例，用于创建从表查询结果实体到指定类型 R 的映射。

continuationToken - 一个 ResultContinuation 对象，表示当操作返回部分结果时服务器中的继续标记。 在初始调用中指定 null 。 getContinuationToken()对结果调用 方法以获取ResultContinuation在下一次调用中使用的 对象，以恢复查询。

options - 一个 TableRequestOptions 对象，该对象指定执行选项，例如操作的重试策略和超时设置。 指定 null 以使用 上 CloudTableClient指定的请求选项。

opContext - 用于跟踪当前操作的 OperationContext 对象。 指定 null 以安全地忽略操作上下文。

Returns:

一个 ResultSegment<T>，包含查询执行结果到类型 R 的映射。

Throws:

StorageException - 如果在操作期间发生存储服务错误，则为 。

executeSegmented

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

使用 ResultContinuation 延续标记在分段模式下执行查询。 使用 执行查询允许使用 对象中的 ResultSegment<T> 服务器返回的信息，在返回部分结果后恢复查询。

此方法将使用此实例的表服务终结点和存储帐户凭据调用表服务 REST API 上的查询实体操作来查询表。

Parameters:

query - 一个 TableQuery<T> 实例，指定要查询的表和要使用的查询参数，专用于实现 的 TableEntityT 类型。

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> 服务器返回的信息，在返回部分结果后恢复查询。

此方法将使用此实例的表服务终结点和存储帐户凭据调用表服务 REST API 上的查询实体操作来查询表。

TableRequestOptions使用 替代操作的超时或重试策略等执行选项。

Parameters:

query - 一个 TableQuery<T> 实例，指定要查询的表和要使用的查询参数，专用于实现 的 TableEntityT 类型。

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 允许的 Internet 协议的 。

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 - 如果发生存储服务错误。