Compartilhar via


Database Columns - Get

Obter coluna de banco de dados

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/schemas/{schemaName}/tables/{tableName}/columns/{columnName}?api-version=2021-11-01

Parâmetros de URI

Nome Em Obrigatório Tipo Description
columnName
path True

string

O nome da coluna.

databaseName
path True

string

O nome do banco de dados.

resourceGroupName
path True

string

O nome do grupo de recursos que contém o recurso. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.

schemaName
path True

string

O nome do esquema.

serverName
path True

string

O nome do servidor.

subscriptionId
path True

string

A ID de assinatura que identifica uma assinatura do Azure.

tableName
path True

string

O nome da tabela.

api-version
query True

string

A versão da API a ser usada para a solicitação.

Respostas

Nome Tipo Description
200 OK

DatabaseColumn

Coluna de banco de dados recuperada com êxito.

Other Status Codes

Respostas de erro: ***

  • 400 UpdateNotAllowedOnPausedDatabase – O usuário tentou executar uma atualização em um banco de dados em pausa.

  • 404 SubscriptionDoesNotHaveServer – O servidor solicitado não foi encontrado

  • 404 SourceDatabaseNotFound – O banco de dados de origem não existe.

  • 404 DatabaseDoesNotExist – o usuário especificou um nome de banco de dados que não existe nesta instância do servidor.

  • 404 ResourceDoesNotExist – o recurso com o nome '{0}' não existe. Para continuar, especifique um nome de recurso válido.

  • 404 InvalidDatabaseSchema – O esquema está ausente no banco de dados.

  • 404 InvalidDatabaseTable – a tabela está ausente no banco de dados.

  • 404 InvalidDatabaseColumn – a coluna está ausente na tabela.

  • 503 DatabaseUnavailable – A operação falhou porque o banco de dados não está disponível.

Exemplos

Get database column

Solicitação de exemplo

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/servers/serverName/databases/myDatabase/schemas/dbo/tables/table1/columns/column1?api-version=2021-11-01

Resposta de exemplo

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/servers/serverName/databases/myDatabase/schemas/dbo/tables/table1/columns/column1",
  "name": "column1",
  "type": "Microsoft.Sql/servers/databases/schemas/tables/columns",
  "properties": {
    "columnType": "bit",
    "temporalType": "SystemVersionedTemporalTable",
    "memoryOptimized": false,
    "isComputed": false
  }
}

Definições

Nome Description
ColumnDataType

O tipo de dados de coluna.

DatabaseColumn

Um recurso de coluna de banco de dados.

TableTemporalType

O tipo temporal da tabela.

ColumnDataType

O tipo de dados de coluna.

Valor Description
bigint
binary
bit
char
date
datetime
datetime2
datetimeoffset
decimal
float
geography
geometry
hierarchyid
image
int
money
nchar
ntext
numeric
nvarchar
real
smalldatetime
smallint
smallmoney
sql_variant
sysname
text
time
timestamp
tinyint
uniqueidentifier
varbinary
varchar
xml

DatabaseColumn

Um recurso de coluna de banco de dados.

Nome Tipo Description
id

string

ID do recurso.

name

string

Nome do recurso.

properties.columnType

ColumnDataType

O tipo de dados de coluna.

properties.isComputed

boolean

Se a coluna é computada ou não.

properties.memoryOptimized

boolean

Se a coluna pertence ou não a uma tabela com otimização de memória.

properties.temporalType

TableTemporalType

O tipo temporal da tabela.

type

string

Tipo de recurso.

TableTemporalType

O tipo temporal da tabela.

Valor Description
HistoryTable
NonTemporalTable
SystemVersionedTemporalTable