CloudTable Classe

Pacote:

com.microsoft.azure.storage.table

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

public class CloudTable

Representa uma tabela no serviço Tabela do Microsoft Azure.

Resumo do Construtor

Construtor	Description
CloudTable(final StorageUri uri)	Cria uma instância da classe usando o URI de tabela especificado. O URI da tabela deve incluir um token SAS.
CloudTable(final StorageUri uri, final StorageCredentials credentials)	Cria uma instância da classe usando a tabela especificada StorageUri e as credenciais.
CloudTable(final String tableName, final CloudTableClient client)	Cria uma instância da classe usando o nome e o cliente especificados.
CloudTable(final URI uri)	Cria uma instância da classe usando o URI de tabela especificado. O URI da tabela deve incluir um token SAS.
CloudTable(final URI uri, final StorageCredentials credentials)	Cria uma instância da classe usando o URI e as credenciais de tabela especificados.

Resumo do método

Modificador e tipo	Método e descrição
void	create() Cria a tabela no serviço de armazenamento com opções de solicitação padrão. Esse método invoca a API REST Criar Tabela para criar a tabela especificada, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.
void	create(TableRequestOptions options, OperationContext opContext) Cria a tabela no serviço de armazenamento usando o especificado TableRequestOptions e OperationContexto . Esse método invoca a API REST Criar Tabela para criar a tabela especificada, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância. Use o TableRequestOptions para substituir opções de execução, como o tempo limite ou a política de repetição para a operação.
boolean	createIfNotExists() Cria a tabela no serviço de armazenamento usando opções de solicitação padrão se ela ainda não existir.
boolean	createIfNotExists(TableRequestOptions options, OperationContext opContext) Cria a tabela no serviço de armazenamento com as opções de solicitação especificadas e o contexto de operação, se ela ainda não existir.
void	delete() Exclui a tabela do serviço de armazenamento.
void	delete(TableRequestOptions options, OperationContext opContext) Exclui a tabela do serviço de armazenamento, usando as opções de solicitação especificadas e o contexto de operação.
boolean	deleteIfExists() Exclui a tabela do serviço de armazenamento, se ela existir.
boolean	deleteIfExists(TableRequestOptions options, OperationContext opContext) Exclui a tabela do serviço de armazenamento usando as opções de solicitação especificadas e o contexto de operação, se ela existir.
TablePermissions	downloadPermissions() Baixa as configurações de permissão para a tabela.
TablePermissions	downloadPermissions(TableRequestOptions options, OperationContext opContext) Baixa as configurações de permissões para a tabela usando as opções de solicitação especificadas e o contexto de operação.
ArrayList<TableResult>	execute(final TableBatchOperation batch) Executa a operação de lote especificada em uma tabela como uma operação atômica. Uma operação em lote pode conter até 100 operações de tabela individual, com o requisito de que cada entidade de operação deve ter a mesma chave de partição. Somente uma operação de recuperação é permitida por lote. Observe que a carga total de uma operação em lote é limitada a 4MB. Esse método invoca uma Transação de Grupo de Entidades na API REST para executar a operação em lote especificada na tabela como uma unidade atômica, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.
ArrayList<TableResult>	execute(final TableBatchOperation batch, TableRequestOptions options, OperationContext opContext) Executa a operação de lote especificada em uma tabela como uma operação atômica, usando o especificado TableRequestOptions e OperationContexto . Uma operação em lote pode conter até 100 operações de tabela individual, com o requisito de que cada entidade de operação deve ter a mesma chave de partição. Somente uma operação de recuperação é permitida por lote. Observe que a carga total de uma operação em lote é limitada a 4MB. Esse método invoca uma Transação de Grupo de Entidades na API REST para executar a operação em lote especificada na tabela como uma unidade atômica, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância. Use o TableRequestOptions para substituir opções de execução, como o tempo limite ou a política de repetição para a operação.
TableResult	execute(final TableOperation operation) Executa a operação em uma tabela. Esse método invocará a API REST do Serviço de Tabela para executar a operação especificada na tabela, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.
TableResult	execute(final TableOperation operation, final TableRequestOptions options, final OperationContext opContext) Executa a operação em uma tabela, usando o TableRequestOptions e OperationContext especificados. Esse método invocará a API REST do Serviço de Tabela para executar a operação especificada na tabela, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância. Use o TableRequestOptions para substituir opções de execução, como o tempo limite ou a política de repetição para a operação.
<R> Iterable<R>	execute(final TableQuery<?> query, final EntityResolver<R> resolver) Executa uma consulta, aplicando o especificado EntityResolver<T> ao resultado. Esse método invocará uma operação entidades de consulta na API REST do Serviço de Tabela para consultar a tabela, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.
<R> Iterable<R>	execute(final TableQuery<?> query, final EntityResolver<R> resolver, final TableRequestOptions options, final OperationContext opContext) Executa uma consulta, aplicando o especificado EntityResolver<T> ao resultado, usando o especificado TableRequestOptions e OperationContext. Esse método invocará uma operação entidades de consulta na API REST do Serviço de Tabela para consultar a tabela, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância. Use o TableRequestOptions para substituir opções de execução, como o tempo limite ou a política de repetição para a operação.
<T extends TableEntity> Iterable<T>	execute(final TableQuery<T> query) Executa uma consulta. Esse método invocará uma operação entidades de consulta na API REST do Serviço de Tabela para consultar a tabela, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.
<T extends TableEntity> Iterable<T>	execute(final TableQuery<T> query, final TableRequestOptions options, final OperationContext opContext) Executa uma consulta, usando o especificado TableRequestOptions e OperationContext. Esse método invocará uma operação entidades de consulta na API REST do Serviço de Tabela para consultar a tabela, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância. Use o TableRequestOptions para substituir opções de execução, como o tempo limite ou a política de repetição para a operação.
<R> ResultSegment<R>	executeSegmented(final TableQuery<?> query, final EntityResolver<R> resolver, final ResultContinuation continuationToken) Executa uma consulta no modo segmentado com o token de continuação especificado ResultContinuation , aplicando o EntityResolver<T> ao resultado. A execução de uma consulta com permite que a consulta seja retomada após o retorno de resultados parciais, usando as informações retornadas pelo servidor no ResultSegment<T> objeto . Esse método invocará uma operação entidades de consulta na API REST do Serviço de Tabela para consultar a tabela, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.
<R> ResultSegment<R>	executeSegmented(final TableQuery<?> query, final EntityResolver<R> resolver, final ResultContinuation continuationToken, final TableRequestOptions options, final OperationContext opContext) Executa uma consulta no modo segmentado com o token de continuação especificado ResultContinuation , usando o especificado TableRequestOptions e OperationContext, aplicando o EntityResolver<T> ao resultado. A execução de uma consulta com permite que a consulta seja retomada após o retorno de resultados parciais, usando as informações retornadas pelo servidor no ResultSegment<T> objeto . Esse método invocará uma operação entidades de consulta na API REST do Serviço de Tabela para consultar a tabela, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância. Use o TableRequestOptions para substituir opções de execução, como o tempo limite ou a política de repetição para a operação.
<T extends TableEntity> ResultSegment<T>	executeSegmented(final TableQuery<T> query, final ResultContinuation continuationToken) Executa uma consulta no modo segmentado com um ResultContinuation token de continuação. A execução de uma consulta com permite que a consulta seja retomada após o retorno de resultados parciais, usando as informações retornadas pelo servidor no ResultSegment<T> objeto . Esse método invocará uma operação entidades de consulta na API REST do Serviço de Tabela para consultar a tabela, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.
<T extends TableEntity> ResultSegment<T>	executeSegmented(final TableQuery<T> query, final ResultContinuation continuationToken, final TableRequestOptions options, final OperationContext opContext) Executa uma consulta no modo segmentado com um ResultContinuation token de continuação, usando o especificado TableRequestOptions e OperationContexto . A execução de uma consulta com permite que a consulta seja retomada após o retorno de resultados parciais, usando as informações retornadas pelo servidor no ResultSegment<T> objeto . Esse método invocará uma operação entidades de consulta na API REST do Serviço de Tabela para consultar a tabela, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância. Use o TableRequestOptions para substituir opções de execução, como o tempo limite ou a política de repetição para a operação.
boolean	exists() Retorna um valor que indica se a tabela existe no serviço de armazenamento.
boolean	exists(TableRequestOptions options, OperationContext opContext) Retorna um valor que indica se a tabela existe no serviço de armazenamento, usando as opções de solicitação especificadas e o contexto de operação.
String	generateSharedAccessSignature(final SharedAccessTablePolicy policy, final String accessPolicyIdentifier, final String startPartitionKey, final String startRowKey, final String endPartitionKey, final String endRowKey) Cria uma assinatura de acesso compartilhado para a tabela.
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) Cria uma assinatura de acesso compartilhado para a tabela.
String	getName() Obtém o nome da tabela.
CloudTableClient	getServiceClient() Obtém o cliente de serviço de tabela associado a essa fila.
final StorageUri	getStorageUri() Retorna a lista de URIs para todos os locais.
URI	getUri() Obtém o URI absoluto para esta tabela.
void	uploadPermissions(final TablePermissions permissions) Carrega as permissões da tabela.
void	uploadPermissions(final TablePermissions permissions, TableRequestOptions options, OperationContext opContext) Carrega as permissões da tabela usando as opções de solicitação especificadas e o contexto de operação.

Detalhes do construtor

CloudTable

public CloudTable(final StorageUri uri)

Cria uma instância da classe usando o URI de tabela especificado. O URI da tabela deve incluir um token SAS.

Parameters:

uri - Um StorageUri objeto que representa o URI absoluto da tabela.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

CloudTable

public CloudTable(final StorageUri uri, final StorageCredentials credentials)

Cria uma instância da classe usando a tabela especificada StorageUri e as credenciais.

Parameters:

uri - Um StorageUri objeto que representa o StorageUri absoluto da tabela.

credentials - Um StorageCredentials objeto usado para autenticar o acesso.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

CloudTable

protected CloudTable(final String tableName, final CloudTableClient client)

Cria uma instância da classe usando o nome e o cliente especificados.

Parameters:

tableName - Um String que representa o nome da tabela, que deve seguir as regras de nomenclatura de tabela. O nome da tabela não deve incluir nenhum caractere separador de caminho (/). Os nomes de tabela não diferenciam maiúsculas de minúsculas, devem ser exclusivos em uma conta e devem ter entre 3 a 63 caracteres. Os nomes de tabela devem começar com um não pode começar com um caractere numérico e podem conter apenas caracteres alfanuméricos. Alguns nomes de tabela são reservados, incluindo "table".

client - Um CloudTableClient objeto que representa o cliente de serviço associado e que especifica o ponto de extremidade para o serviço Tabela.

Throws:

URISyntaxException - Se o URI do recurso construído com base no tableName for inválido.

StorageException - Se ocorreu um erro de serviço de armazenamento.

CloudTable

public CloudTable(final URI uri)

Cria uma instância da classe usando o URI de tabela especificado. O URI da tabela deve incluir um token SAS.

Parameters:

uri - Um java.net.URI objeto que representa o URI absoluto da tabela.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

CloudTable

public CloudTable(final URI uri, final StorageCredentials credentials)

Cria uma instância da classe usando o URI e as credenciais de tabela especificados.

Parameters:

uri - Um java.net.URI objeto que representa o URI absoluto da tabela.

credentials - Um StorageCredentials objeto usado para autenticar o acesso.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

Detalhes do método

create

public void create()

Cria a tabela no serviço de armazenamento com opções de solicitação padrão.

Esse método invoca a API REST Criar Tabela para criar a tabela especificada, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento durante a operação.

create

public void create(TableRequestOptions options, OperationContext opContext)

Cria a tabela no serviço de armazenamento usando o especificado TableRequestOptions e OperationContexto .

Esse método invoca a API REST Criar Tabela para criar a tabela especificada, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.

Use o TableRequestOptions para substituir opções de execução, como o tempo limite ou a política de repetição para a operação.

Parameters:

options - Um TableRequestOptions objeto que especifica opções de execução, como política de repetição e configurações de tempo limite para a operação. Especifique null para usar as opções de solicitação especificadas no CloudTableClient.

opContext - Um objeto OperationContext para rastrear a operação atual. Especifique null para ignorar com segurança o contexto da operação.

Throws:

StorageException - Se ocorrer um erro ao acessar o serviço de armazenamento ou porque a tabela não pode ser criada ou já existe.

createIfNotExists

public boolean createIfNotExists()

Cria a tabela no serviço de armazenamento usando opções de solicitação padrão se ela ainda não existir.

Returns:

true se a tabela for criada no serviço de armazenamento; caso contrário false, .

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento durante a operação.

createIfNotExists

public boolean createIfNotExists(TableRequestOptions options, OperationContext opContext)

Cria a tabela no serviço de armazenamento com as opções de solicitação especificadas e o contexto de operação, se ela ainda não existir.

Parameters:

options - Um TableRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null usará as opções de solicitação padrão do cliente de serviço associado ( CloudTableClient).

opContext - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Returns:

true se a tabela ainda não existir e tiver sido criada; caso contrário false , .

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento durante a operação.

delete

public void delete()

Exclui a tabela do serviço de armazenamento.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento durante a operação.

delete

public void delete(TableRequestOptions options, OperationContext opContext)

Exclui a tabela do serviço de armazenamento, usando as opções de solicitação especificadas e o contexto de operação.

Parameters:

options - Um TableRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null usará as opções de solicitação padrão do cliente de serviço associado ( CloudTableClient).

opContext - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento durante a operação.

deleteIfExists

public boolean deleteIfExists()

Exclui a tabela do serviço de armazenamento, se ela existir.

Returns:

true se a tabela existir no serviço de armazenamento e tiver sido excluída; caso contrário false, .

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento durante a operação.

deleteIfExists

public boolean deleteIfExists(TableRequestOptions options, OperationContext opContext)

Exclui a tabela do serviço de armazenamento usando as opções de solicitação especificadas e o contexto de operação, se ela existir.

Parameters:

options - Um TableRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null usará as opções de solicitação padrão do cliente de serviço associado ( CloudTableClient).

opContext - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Returns:

Um valor de true se a tabela existia no serviço de armazenamento e foi excluída, caso contrário false, .

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento durante a operação.

downloadPermissions

public TablePermissions downloadPermissions()

Baixa as configurações de permissão para a tabela.

Returns:

Um TablePermissions objeto que representa as permissões do contêiner.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

downloadPermissions

public TablePermissions downloadPermissions(TableRequestOptions options, OperationContext opContext)

Baixa as configurações de permissões para a tabela usando as opções de solicitação especificadas e o contexto de operação.

Parameters:

options - Um TableRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null usará as opções de solicitação padrão do cliente de serviço associado ( CloudTableClient).

opContext - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Returns:

Um TablePermissions objeto que representa as permissões da tabela.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

execute

public ArrayList execute(final TableBatchOperation batch)

Executa a operação de lote especificada em uma tabela como uma operação atômica. Uma operação em lote pode conter até 100 operações de tabela individual, com o requisito de que cada entidade de operação deve ter a mesma chave de partição. Somente uma operação de recuperação é permitida por lote. Observe que a carga total de uma operação em lote é limitada a 4MB.

Esse método invoca uma Transação de Grupo de Entidades na API REST para executar a operação em lote especificada na tabela como uma unidade atômica, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.

Parameters:

batch - O objeto TableBatchOperation que representa as operações para executar na tabela.

Returns:

Um java.util.ArrayList de TableResult que contém os resultados, em ordem, de cada TableOperation um na TableBatchOperation tabela nomeada.

Throws:

StorageException - se ocorrer um erro ao acessar o serviço de armazenamento ou se a operação falhar.

execute

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

Executa a operação de lote especificada em uma tabela como uma operação atômica, usando o especificado TableRequestOptions e OperationContexto . Uma operação em lote pode conter até 100 operações de tabela individual, com o requisito de que cada entidade de operação deve ter a mesma chave de partição. Somente uma operação de recuperação é permitida por lote. Observe que a carga total de uma operação em lote é limitada a 4MB.

Esse método invoca uma Transação de Grupo de Entidades na API REST para executar a operação em lote especificada na tabela como uma unidade atômica, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.

Use o TableRequestOptions para substituir opções de execução, como o tempo limite ou a política de repetição para a operação.

Parameters:

batch - O objeto TableBatchOperation que representa as operações para executar na tabela.

options - Um TableRequestOptions objeto que especifica opções de execução, como política de repetição e configurações de tempo limite para a operação. Especifique null para usar as opções de solicitação especificadas no CloudTableClient.

opContext - Um objeto OperationContext para rastrear a operação atual. Especifique null para ignorar com segurança o contexto da operação.

Returns:

Um java.util.ArrayList de TableResult que contém os resultados, em ordem, de cada TableOperation um na TableBatchOperation tabela nomeada.

Throws:

StorageException - se ocorrer um erro ao acessar o serviço de armazenamento ou se a operação falhar.

execute

public TableResult execute(final TableOperation operation)

Executa a operação em uma tabela.

Esse método invocará a API REST do Serviço de Tabela para executar a operação especificada na tabela, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.

Parameters:

operation - O TableOperation objeto que representa a operação a ser executada na tabela.

Returns:

Um TableResult que contém o resultado da execução do TableOperation na tabela.

Throws:

StorageException - se ocorrer um erro ao acessar o serviço de armazenamento ou se a operação falhar.

execute

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

Executa a operação em uma tabela, usando o TableRequestOptions e OperationContext especificados.

Esse método invocará a API REST do Serviço de Tabela para executar a operação especificada na tabela, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.

Use o TableRequestOptions para substituir opções de execução, como o tempo limite ou a política de repetição para a operação.

Parameters:

operation - O TableOperation objeto que representa a operação a ser executada na tabela.

options - Um TableRequestOptions objeto que especifica opções de execução, como política de repetição e configurações de tempo limite para a operação. Especifique null para usar as opções de solicitação especificadas no CloudTableClient.

opContext - Um objeto OperationContext para rastrear a operação atual. Especifique null para ignorar com segurança o contexto da operação.

Returns:

Um TableResult que contém o resultado da execução do TableOperation na tabela.

Throws:

StorageException - se ocorrer um erro ao acessar o serviço de armazenamento ou se a operação falhar.

execute

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

Executa uma consulta, aplicando o especificado EntityResolver<T> ao resultado.

Esse método invocará uma operação entidades de consulta na API REST do Serviço de Tabela para consultar a tabela, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.

Parameters:

query - Uma TableQuery<T> instância que especifica a tabela a ser consultada e os parâmetros de consulta a serem usados.

resolver - Uma instância EntityResolver<T> que cria uma projeção de entidades de resultado da consulta de tabela para o tipo R especificado.

Returns:

Uma coleção que implementa a Iterable interface que contém a projeção no tipo R dos resultados da execução da consulta.

execute

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

Executa uma consulta, aplicando o especificado EntityResolver<T> ao resultado, usando o especificado TableRequestOptions e OperationContext.

Esse método invocará uma operação entidades de consulta na API REST do Serviço de Tabela para consultar a tabela, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.

Use o TableRequestOptions para substituir opções de execução, como o tempo limite ou a política de repetição para a operação.

Parameters:

query - Uma TableQuery<T> instância que especifica a tabela a ser consultada e os parâmetros de consulta a serem usados.

resolver - Uma instância EntityResolver<T> que cria uma projeção de entidades de resultado da consulta de tabela para o tipo R especificado.

options - Um TableRequestOptions objeto que especifica opções de execução, como política de repetição e configurações de tempo limite para a operação. Especifique null para usar as opções de solicitação especificadas no CloudTableClient.

opContext - Um objeto OperationContext para rastrear a operação atual. Especifique null para ignorar com segurança o contexto da operação.

Returns:

Uma coleção que implementa a Iterable interface que contém a projeção no tipo R dos resultados da execução da consulta.

execute

public Iterable execute(final TableQuery query)

Executa uma consulta.

Esse método invocará uma operação entidades de consulta na API REST do Serviço de Tabela para consultar a tabela, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.

Parameters:

query - Uma TableQuery<T> instância que especifica a tabela a ser consultada e os parâmetros de consulta a serem usados, especializada para um tipo T que implementa TableEntity.

Returns:

Uma coleção que implementa a Iterable interface especializada para o tipo T dos resultados da execução da consulta.

execute

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

Executa uma consulta, usando o especificado TableRequestOptions e OperationContext.

Esse método invocará uma operação entidades de consulta na API REST do Serviço de Tabela para consultar a tabela, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.

Use o TableRequestOptions para substituir opções de execução, como o tempo limite ou a política de repetição para a operação.

Parameters:

query - Uma TableQuery<T> instância que especifica a tabela a ser consultada e os parâmetros de consulta a serem usados, especializada para um tipo T que implementa TableEntity.

options - Um TableRequestOptions objeto que especifica opções de execução, como política de repetição e configurações de tempo limite para a operação. Especifique null para usar as opções de solicitação especificadas no CloudTableClient.

opContext - Um objeto OperationContext para rastrear a operação atual. Especifique null para ignorar com segurança o contexto da operação.

Returns:

Uma coleção que implementa a Iterable interface especializada para o tipo T dos resultados da execução da consulta.

executeSegmented

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

Executa uma consulta no modo segmentado com o token de continuação especificado ResultContinuation , aplicando o EntityResolver<T> ao resultado. A execução de uma consulta com permite que a consulta seja retomada após o retorno de resultados parciais, usando as informações retornadas pelo servidor no ResultSegment<T> objeto .

Esse método invocará uma operação entidades de consulta na API REST do Serviço de Tabela para consultar a tabela, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.

Parameters:

query - Uma TableQuery<T> instância que especifica a tabela a ser consultada e os parâmetros de consulta a serem usados.

resolver - Uma instância EntityResolver<T> que cria uma projeção de entidades de resultado da consulta de tabela para o tipo R especificado.

continuationToken - Um objeto ResultContinuation que representa um token de continuação do servidor quando a operação retorna um resultado parcial. Especifique null na chamada inicial. Chame o getContinuationToken() método no resultado para obter o ResultContinuation objeto a ser usado na próxima chamada para retomar a consulta.

Returns:

Um ResultSegment<T> contendo a projeção no tipo R dos resultados da execução da consulta.

Throws:

StorageException - se ocorreu um erro de serviço de armazenamento durante a operação.

executeSegmented

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

Executa uma consulta no modo segmentado com o token de continuação especificado ResultContinuation , usando o especificado TableRequestOptions e OperationContext, aplicando o EntityResolver<T> ao resultado. A execução de uma consulta com permite que a consulta seja retomada após o retorno de resultados parciais, usando as informações retornadas pelo servidor no ResultSegment<T> objeto .

Esse método invocará uma operação entidades de consulta na API REST do Serviço de Tabela para consultar a tabela, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.

Use o TableRequestOptions para substituir opções de execução, como o tempo limite ou a política de repetição para a operação.

Parameters:

query - Uma TableQuery<T> instância que especifica a tabela a ser consultada e os parâmetros de consulta a serem usados.

resolver - Uma instância EntityResolver<T> que cria uma projeção de entidades de resultado da consulta de tabela para o tipo R especificado.

continuationToken - Um objeto ResultContinuation que representa um token de continuação do servidor quando a operação retorna um resultado parcial. Especifique null na chamada inicial. Chame o getContinuationToken() método no resultado para obter o ResultContinuation objeto a ser usado na próxima chamada para retomar a consulta.

options - Um TableRequestOptions objeto que especifica opções de execução, como política de repetição e configurações de tempo limite para a operação. Especifique null para usar as opções de solicitação especificadas no CloudTableClient.

opContext - Um objeto OperationContext para rastrear a operação atual. Especifique null para ignorar com segurança o contexto da operação.

Returns:

Um ResultSegment<T> contendo a projeção no tipo R dos resultados da execução da consulta.

Throws:

StorageException - se ocorreu um erro de serviço de armazenamento durante a operação.

executeSegmented

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

Executa uma consulta no modo segmentado com um ResultContinuation token de continuação. A execução de uma consulta com permite que a consulta seja retomada após o retorno de resultados parciais, usando as informações retornadas pelo servidor no ResultSegment<T> objeto .

Esse método invocará uma operação entidades de consulta na API REST do Serviço de Tabela para consultar a tabela, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.

Parameters:

query - Uma TableQuery<T> instância que especifica a tabela a ser consultada e os parâmetros de consulta a serem usados, especializada para um tipo T que implementa TableEntity.

continuationToken - Um objeto ResultContinuation que representa um token de continuação do servidor quando a operação retorna um resultado parcial. Especifique null na chamada inicial. Chame o getContinuationToken() método no resultado para obter o ResultContinuation objeto a ser usado na próxima chamada para retomar a consulta.

Returns:

Um ResultSegment<T> especializado para o tipo T dos resultados da execução da consulta.

Throws:

StorageException - se ocorreu um erro de serviço de armazenamento durante a operação.

executeSegmented

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

Executa uma consulta no modo segmentado com um ResultContinuation token de continuação, usando o especificado TableRequestOptions e OperationContexto . A execução de uma consulta com permite que a consulta seja retomada após o retorno de resultados parciais, usando as informações retornadas pelo servidor no ResultSegment<T> objeto .

Esse método invocará uma operação entidades de consulta na API REST do Serviço de Tabela para consultar a tabela, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.

Use o TableRequestOptions para substituir opções de execução, como o tempo limite ou a política de repetição para a operação.

Parameters:

query - Uma TableQuery<T> instância que especifica a tabela a ser consultada e os parâmetros de consulta a serem usados, especializada para um tipo T que implementa TableEntity.

continuationToken - Um objeto ResultContinuation que representa um token de continuação do servidor quando a operação retorna um resultado parcial. Especifique null na chamada inicial. Chame o getContinuationToken() método no resultado para obter o ResultContinuation objeto a ser usado na próxima chamada para retomar a consulta.

options - Um TableRequestOptions objeto que especifica opções de execução, como política de repetição e configurações de tempo limite para a operação. Especifique null para usar as opções de solicitação especificadas no CloudTableClient.

opContext - Um objeto OperationContext para rastrear a operação atual. Especifique null para ignorar com segurança o contexto da operação.

Returns:

Um ResultSegment<T> especializado para o tipo T dos resultados da execução da consulta.

Throws:

StorageException - se ocorreu um erro de serviço de armazenamento durante a operação.

exists

public boolean exists()

Retorna um valor que indica se a tabela existe no serviço de armazenamento.

Returns:

true se a tabela existir no serviço de armazenamento; caso contrário false, .

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento durante a operação.

exists

public boolean exists(TableRequestOptions options, OperationContext opContext)

Retorna um valor que indica se a tabela existe no serviço de armazenamento, usando as opções de solicitação especificadas e o contexto de operação.

Parameters:

options - Um TableRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null usará as opções de solicitação padrão do cliente de serviço associado ( CloudTableClient).

opContext - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Returns:

true se a tabela existir no serviço de armazenamento, caso contrário false, .

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento durante a operação.

generateSharedAccessSignature

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

Cria uma assinatura de acesso compartilhado para a tabela.

Parameters:

policy - Um SharedAccessTablePolicy objeto que representa a política de acesso para a assinatura de acesso compartilhado.

accessPolicyIdentifier - Um String que representa uma política de acesso no nível da tabela.

startPartitionKey - Um String que representa a chave de partição inicial.

startRowKey - Um String que representa a chave de linha inicial.

endPartitionKey - Um String que representa a chave de partição final.

endRowKey - Um String que representa a chave final final.

Returns:

Um String que contém a assinatura de acesso compartilhado para a tabela.

Throws:

InvalidKeyException - Se uma chave inválida foi passada.

StorageException - Se ocorreu um erro de serviço de armazenamento.

IllegalArgumentException - Se um valor inesperado for passado.

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)

Cria uma assinatura de acesso compartilhado para a tabela.

Parameters:

policy - Um SharedAccessTablePolicy objeto que representa a política de acesso para a assinatura de acesso compartilhado.

accessPolicyIdentifier - Um String que representa uma política de acesso no nível da tabela.

startPartitionKey - Um String que representa a chave de partição inicial.

startRowKey - Um String que representa a chave de linha inicial.

endPartitionKey - Um String que representa a chave de partição final.

endRowKey - Um String que representa a chave final final.

ipRange - Um IPRange objeto que contém o intervalo de endereços IP permitidos.

protocols - Um SharedAccessProtocols que representa os protocolos de Internet permitidos.

Returns:

Um String que contém a assinatura de acesso compartilhado para a tabela.

Throws:

InvalidKeyException - Se uma chave inválida foi passada.

StorageException - Se ocorreu um erro de serviço de armazenamento.

IllegalArgumentException - Se um valor inesperado for passado.

getName

public String getName()

Obtém o nome da tabela.

Returns:

Um String objeto que representa o nome da tabela.

getServiceClient

public CloudTableClient getServiceClient()

Obtém o cliente de serviço de tabela associado a essa fila.

Returns:

Um CloudTableClient objeto que representa o cliente de serviço associado a esta tabela.

getStorageUri

public final StorageUri getStorageUri()

Retorna a lista de URIs para todos os locais.

Returns:

Um StorageUri que representa a lista de URIs para todos os locais..

getUri

public URI getUri()

Obtém o URI absoluto para esta tabela.

Returns:

Um java.net.URI objeto que representa o URI desta tabela.

uploadPermissions

public void uploadPermissions(final TablePermissions permissions)

Carrega as permissões da tabela.

Parameters:

permissions - Um TablePermissions objeto que representa as permissões para carregar.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

uploadPermissions

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

Carrega as permissões da tabela usando as opções de solicitação especificadas e o contexto de operação.

Parameters:

permissions - Um TablePermissions objeto que representa as permissões para carregar.

options - Um TableRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null usará as opções de solicitação padrão do cliente de serviço associado ( CloudTableClient).

opContext - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.