Criar a Tabela

  • Artigo

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

Pedir

Pode construir o Create Table pedido, conforme mostrado aqui. Recomendamos que utilize HTTPS. Substitua myaccount pelo nome da sua conta de armazenamento:

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

Pedido de serviço de armazenamento emulado

Quando estiver a fazer um pedido contra o serviço de armazenamento emulado, especifique o nome do anfitrião do emulador e a porta do Armazenamento de Tabelas do Azure como 127.0.0.1:10002, seguido do nome da conta de armazenamento emulada:

Método URI do pedido 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 Armazenamento de Tabelas de várias formas. Para obter mais informações, veja Diferenças entre o emulador de armazenamento e os serviços de Armazenamento do Azure.

Parâmetros URI

Nenhum.

Cabeçalhos do pedido

Os cabeçalhos de pedido obrigatórios e opcionais estão descritos na seguinte tabela:

Cabeçalho do pedido Description
Authorization Obrigatório. Especifica o esquema de autorização, o nome da conta e a assinatura. Para obter mais informações, veja Autorizar pedidos para o Armazenamento do Azure.
Date ou x-ms-date Obrigatório. Especifica a Hora Universal Coordenada (UTC) do pedido. Para obter mais informações, veja Autorizar pedidos para o Armazenamento do Azure.
x-ms-version Opcional. Especifica a versão da operação a utilizar para este pedido. Para obter mais informações, veja Controlo de versões dos serviços de Armazenamento do Azure.
Content-Type Obrigatório. Especifica o tipo de conteúdo do payload. Os valores possíveis são:

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

Para obter mais informações, veja Formato payload para operações de Armazenamento de Tabelas.
Accept Opcional. Especifica o tipo de conteúdo aceite do payload de resposta. Os valores possíveis são:

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

Para obter mais informações, veja Payload Format for Table Service Operations (Formato payload para Operações de Serviço de Tabela).
Prefer Opcional. Especifica se a resposta deve incluir a entidade inserida no payload. Os valores possíveis são return-no-content e return-content.

Para obter mais informações sobre este cabeçalho, consulte Definir o cabeçalho para gerir o Prefer eco de resposta nas operações de inserção.
Content-Length Obrigatório. O comprimento do corpo do pedido.
x-ms-client-request-id Opcional. Fornece um valor opaco gerado pelo cliente com um limite de carateres de 1 kibibyte (KiB) que é registado nos registos quando o registo é configurado. Recomendamos vivamente que utilize este cabeçalho para correlacionar as atividades do lado do cliente com os pedidos que o servidor recebe. Para obter mais informações, veja Monitorizar o Armazenamento de Tabelas do Azure.

Corpo do pedido

O corpo do pedido especifica o nome da tabela a ser criada. Os nomes das tabelas têm de estar em conformidade com as restrições de nomenclatura descritas em Compreender o modelo de dados de Armazenamento de Tabelas.

O corpo do pedido é um conjunto de entidades OData, que pode ser expresso como JSON ou como um feed Atom.

Nota

JSON é o formato de payload recomendado e é o único formato suportado para a versão 2015-12-11 e posterior.

Para obter orientações sobre nomes de tabela válidos, veja a secção "Nomes de Tabelas" em Compreender o modelo de dados de Armazenamento de Tabelas.

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

O corpo do pedido como um feed JSON está no seguinte formato geral:

{   
    "TableName":"mytable"  
}

Feed atom (versões anteriores a 2015-12-11)

O corpo do pedido 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 estado HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.

Código de estado

O código de estado depende do valor do Prefer cabeçalho. Se o Prefer cabeçalho estiver definido como return-no-content, uma operação bem-sucedida devolve o código de estado 204 (No Content). Se o cabeçalho não estiver especificado ou estiver definido como return-content, uma operação bem-sucedida devolve o Prefer código de estado 201 (Created). Para obter mais informações, veja Definir o cabeçalho para gerir o Prefer eco de resposta nas operações de inserção.

Para obter informações sobre códigos de estado, veja Códigos de estado e de erro e códigos de erro do Armazenamento de Tabelas.

Cabeçalhos de resposta

A resposta para esta operação inclui os cabeçalhos descritos na tabela seguinte. 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 o pedido que foi feito e pode utilizá-lo para resolver o pedido. Para obter mais informações, veja Resolver problemas de operações da API.
x-ms-version Indica a versão do Armazenamento de Tabelas que foi utilizada para executar o pedido. Este cabeçalho é devolvido para pedidos efetuados 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 do Prefer pedido foi respeitado. Se a resposta não incluir este cabeçalho, o Prefer cabeçalho não foi honrado. Se o cabeçalho for devolvido, o respetivo valor será return-content ou return-no-content.

Para obter mais informações, veja Definir o cabeçalho para gerir o Prefer eco de resposta nas operações de inserção.
Content-Type Indica o tipo de conteúdo do payload. O valor depende do valor especificado para o cabeçalho do Accept pedido. 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, veja Formato payload para operações de Armazenamento de Tabelas.
x-ms-client-request-id Pode ser utilizado para resolver problemas de pedidos e respostas correspondentes. O valor deste cabeçalho é igual ao valor do x-ms-client-request-id cabeçalho se estiver presente no pedido e o valor não contiver mais de 1024 carateres ASCII visíveis. Se o x-ms-client-request-id cabeçalho não estiver presente, não está presente na resposta.

Corpo da resposta

Se o pedido incluir o Prefer cabeçalho com o valor return-no-content, não será devolvido nenhum corpo de resposta. Caso contrário, o corpo da resposta é um conjunto de entidades OData.

Nota

Recomendamos JSON como o formato de payload. É o único formato suportado para a versão 2015-12-11 e posterior.

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

Eis os payloads de resposta em JSON para vários níveis de controlo.

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 2015-12-11)

Segue-se uma resposta do Atom de exemplo 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

Apenas o proprietário da conta pode chamar esta operação.

Observações

Nenhum.

Ver também

Autorizar pedidos para o Armazenamento do Azure
Definir os cabeçalhos da versão do serviço de dados OData
Códigos de estado e de erro
Códigos de erro do Armazenamento de Tabelas