Criar tabela

  • Artigo

A Create Table operação cria uma nova tabela em uma conta de armazenamento.

Solicitação

Você pode construir a solicitação Create Table conforme mostrado aqui. Recomendamos que você use HTTPS. Substitua myaccount pelo nome da sua conta de armazenamento:

Método URI da solicitação Versão HTTP
POST https://myaccount.table.core.windows.net/Tables HTTP/1.1

Solicitação de 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
POST http://127.0.0.1:10002/devstoreaccount1/Tables HTTP/1.1

O serviço Tabela no emulador de armazenamento difere do serviço de Armazenamento de Tabelas 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

Os cabeçalhos de solicitação obrigatórios e opcionais 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.
Accept Opcional. Especifica o tipo de conteúdo aceito da carga de resposta. Os valores possíveis são:

- application/atom+xml (somente versões anteriores a 2015-12-11)
- application/json;odata=nometadata
- application/json;odata=minimalmetadata
- application/json;odata=fullmetadata

Para obter mais informações, consulte Formato de carga para operações de serviço de tabela.
Prefer Opcional. Especifica se a resposta deve incluir a entidade inserida na carga. Os valores possíveis são return-no-content e return-content.

Para obter mais informações sobre esse cabeçalho, consulte Definir o cabeçalho para gerenciar o Prefer eco de resposta em operações de inserção.
Content-Length Obrigatórios. O tamanho do corpo da solicitação.
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

O corpo da solicitação especifica o nome da tabela a ser criada. Os nomes de tabela devem estar em conformidade com as restrições de nomenclatura descritas em Entender o modelo de dados do Armazenamento de Tabelas.

O corpo da solicitação é um conjunto de entidades OData, que pode ser expresso como JSON ou como um feed Atom.

Observação

JSON é o formato de conteúdo recomendado e é o único formato com suporte para a versão 2015-12-11 e posterior.

Para obter diretrizes sobre nomes de tabela válidos, consulte a seção "Nomes de Tabela" em Entender o modelo de dados do Armazenamento de Tabelas.

JSON (versão 2013-08-15 e posterior)

O corpo da solicitação como um feed JSON está no seguinte formato geral:

{   
    "TableName":"mytable"  
}

Atom feed (versões anteriores a 2015-12-11)

O corpo da solicitação como um feed Atom está no seguinte formato geral:

<?xml version="1.0" encoding="utf-8" standalone="yes"?>     
  <entry xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices"   
    xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata"  
    xmlns="https://www.w3.org/2005/Atom">   
    <title />   
    <updated>2009-03-18T11:48:34.9840639-07:00</updated>   
    <author>  
      <name/>   
    </author>   
      <id/>   
      <content type="application/xml">  
        <m:properties>  
          <d:TableName>mytable</d:TableName>  
        </m:properties>  
      </content>   
    </entry>

Resposta

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

Código de status

O código de status depende do valor do cabeçalho Prefer. Se o Prefer cabeçalho estiver definido como return-no-content, uma operação bem-sucedida retornará status código 204 (No Content). Se o Prefer cabeçalho não for especificado ou se estiver definido como return-content, uma operação bem-sucedida retornará status código 201 (Created). Para obter mais informações, consulte Definir o cabeçalho para gerenciar o Prefer eco de resposta em operações de inserção.

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 essa operação inclui os cabeçalhos descritos na tabela 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 Identifica exclusivamente a solicitação que foi feita e você pode usá-la para solucionar problemas da solicitação. Para obter mais informações, consulte Solucionar problemas de operações de API.
x-ms-version Indica a versão do Armazenamento de Tabelas que foi usada para executar a solicitação. Esse cabeçalho é retornado para solicitações feitas na versão 2009-09-19 e posterior.
Date Um valor de data/hora UTC gerado pelo serviço, que indica a hora em que a resposta foi iniciada.
Preference-Applied Indica se o cabeçalho da solicitação Prefer tiver sido cumprido. Se a resposta não incluir esse cabeçalho, o Prefer cabeçalho não foi honrado. Se o cabeçalho for retornado, seu valor será return-content ou return-no-content.

Para obter mais informações, consulte Definir o cabeçalho para gerenciar o Prefer eco de resposta em operações de inserção.
Content-Type Indica o tipo de conteúdo da carga. O valor depende do valor especificado para o cabeçalho da solicitação Accept . Os valores possíveis são:

- application/atom+xml
- application/json;odata=nometadata
- application/json;odata=minimalmetadata
- application/json;odata=fullmetadata

Para obter mais informações sobre tipos de conteúdo, consulte Formato de carga para operações de Armazenamento de Tabelas.
x-ms-client-request-id Pode ser usado para solucionar problemas de solicitações e respostas correspondentes. O valor desse cabeçalho será igual ao valor do x-ms-client-request-id cabeçalho se ele estiver presente na solicitação e o valor não contiver mais de 1.024 caracteres ASCII visíveis. Se o x-ms-client-request-id cabeçalho não estiver presente, ele não estará presente na resposta.

Corpo da resposta

Se a solicitação incluir o cabeçalho Prefer com o valor return-no-content, nenhum corpo de resposta será retornado. Caso contrário, o corpo de resposta será um conjunto de entidades OData.

Observação

Recomendamos JSON como o formato de conteúdo. É o único formato com suporte para a versão 2015-12-11 e posterior.

JSON (versão 2013-08-15 e posterior)

Aqui estão os conteúdos de resposta em JSON para vários níveis de controle.

Metadados completos

{  
  
    "odata.metadata":"https://myaccount.table.core.windows.net/$metadata#Tables/@Element",  
  
    "odata.type":" myaccount.Tables",  
  
    "odata.id":"https://myaccount.table.core.windows.net/Tables('mytable')",  
  
    "odata.editLink":"Tables('mytable')",  
  
    "TableName":"mytable"  
  
}

Metadados mínimos

{  
  
    "odata.metadata":"https://myaccount.table.core.windows.net/$metadata#Tables/@Element",  
  
    "TableName":"mytable"  
  
}

Sem metadados

{  
  
    "TableName":"mytable"  
  
}

Feed Atom (versões anteriores a 11/12/2015)

Aqui está um exemplo de resposta Atom para a Create Table operação.

<?xml version="1.0" encoding="utf-8" standalone="yes"?>  
<entry xml:base="https://myaccount.table.core.windows.net/" xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns="https://www.w3.org/2005/Atom"> <id>https://myaccount.table.core.windows.net/Tables('mytable')</id>  
  <title type="text"></title>  
  <updated>2013-10-24T17:18:54.7062347Z</updated>  
  <author>  
    <name />  
  </author>  
  <link rel="edit" title="Tables" href="Tables('mytable')" />  
  <category term="myaccount.Tables" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />  
  <content type="application/xml">  
    <m:properties>  
      <d:TableName>mytable</d:TableName>  
    </m:properties>  
  </content>  
</entry>

Autorização

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

Comentários

Nenhum.

Confira também

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