Excluir Tabela

  • Artigo

A operação Delete Table exclui a tabela especificada e todos os dados contidos.

Solicitação

Você pode construir a solicitação da Delete Table seguinte maneira. HTTPS é recomendado. Substitua myaccount pelo nome da sua conta de armazenamento e mytable pelo nome da tabela a ser excluída.

Método URI da solicitação Versão HTTP
DELETE https://myaccount.table.core.windows.net/Tables('mytable') HTTP/1.1

URI do serviço de armazenamento emulado

Ao fazer uma solicitação no serviço de armazenamento emulado, especifique o nome do host do emulador e a porta do Armazenamento de Tabelas do Azure como 127.0.0.1:10002, seguido pelo nome da conta de armazenamento emulado.

Método URI da solicitação Versão HTTP
DELETE http://127.0.0.1:10002/devstoreaccount1/Tables('mytable') HTTP/1.1

O Armazenamento de Tabelas no serviço de armazenamento emulado difere do Armazenamento de Tabelas do Azure de várias maneiras. Para obter mais informações, consulte Diferenças entre o emulador de armazenamento e os serviços de Armazenamento do Azure.

Parâmetros do URI

Nenhum.

Cabeçalhos da solicitação

A solicitação deve incluir o Authorization cabeçalho e o Date cabeçalho ou x-ms-date , conforme especificado em Autorizar solicitações para o Armazenamento do Azure. Os cabeçalhos adicionais são descritos na tabela a seguir.

Cabeçalho da solicitação Descrição
Authorization Obrigatórios. Especifica o esquema de autorização, o nome da conta e a assinatura. Para saber mais, confira Autorizar solicitações para o Armazenamento do Azure.
Date ou x-ms-date Obrigatórios. Especifica o UTC (Tempo Universal Coordenado) para a solicitação. Para saber mais, confira Autorizar solicitações para o Armazenamento do Azure.
x-ms-version Opcional. Especifica a versão da operação a ser usada para esta solicitação. Para obter mais informações, consulte Controle de versão para os Serviços de Armazenamento do Azure.
Content-Type Obrigatórios. Especifica o tipo de conteúdo da carga. Os valores possíveis são:

- application/atom+xml (somente versões anteriores a 2015-12-11)
- application/json

Para obter mais informações, consulte Formato de carga para operações de Armazenamento de Tabelas.
x-ms-client-request-id Opcional. Fornece um valor opaco gerado pelo cliente com um limite de caracteres KiB (1 kibibyte) que é registrado nos logs quando o registro em log é configurado. É altamente recomendável que você use esse cabeçalho para correlacionar atividades do lado do cliente com solicitações recebidas pelo servidor. Para obter mais informações, consulte Monitorar o Armazenamento de Tabelas do Azure.

Corpo da solicitação

Nenhum.

Resposta

A resposta inclui um código de status HTTP e um conjunto de cabeçalhos de resposta.

Código de status

Uma operação bem-sucedida retorna o código de status 204 (Sem conteúdo). Para obter informações sobre códigos status, consulte Códigos de erro e status e códigos de erro do Armazenamento de Tabelas.

Cabeçalhos de resposta

A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos HTTP padrão adicionais. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.

Cabeçalho de resposta Descrição
x-ms-request-id Esse cabeçalho identifica exclusivamente a solicitação que foi feita e pode ser usado para solucionar problemas da solicitação. Para obter mais informações, consulte Solução de problemas de operações de API.
x-ms-version Indica a versão do Armazenamento de Tabelas usada para executar a solicitação. Esse cabeçalho é retornado para solicitações feitas na versão 2009-09-19 e mais recente.
Date Um valor de data/hora UTC que indica a hora em que a resposta foi iniciada. Esse serviço gera esse valor.
x-ms-client-request-id Você pode usar esse cabeçalho para solucionar problemas de solicitações e respostas correspondentes. O valor desse cabeçalho é igual ao valor do x-ms-client-request-id cabeçalho, se ele estiver presente na solicitação. O valor é no máximo 1.024 caracteres ASCII visíveis. Se o x-ms-client-request-id cabeçalho não estiver presente na solicitação, esse cabeçalho não estará presente na resposta.

Corpo da resposta

Nenhum.

Autorização

Somente o proprietário da conta pode chamar essa operação.

Comentários

Quando você exclui uma tabela com êxito, ela é marcada imediatamente para exclusão e não está mais acessível.

Observe que provavelmente a exclusão de uma tabela leva, pelo menos, 40 segundos para ser concluída. Se você tentar uma operação na tabela enquanto ela estiver sendo excluída, o serviço retornará status código 409 (Conflito). O serviço retorna informações de erro adicionais indicando que a tabela está sendo excluída.

Confira também

Códigos de erro do Armazenamento de Tabelas
Definindo os cabeçalhos de versão do serviço de dados OData
Autorizar solicitações para o Armazenamento do Azure
Status e códigos de erro