Database Columns - Get

Servizio:

SQL Database

Versione API:

2023-08-01

Ottenere la colonna del database

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
columnName	path	True	string	Nome della colonna.
databaseName	path	True	string	Nome del database.
resourceGroupName	path	True	string	Nome del gruppo di risorse che contiene la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager o dal portale.
schemaName	path	True	string	Nome dello schema.
serverName	path	True	string	Nome del server.
subscriptionId	path	True	string	ID sottoscrizione che identifica una sottoscrizione di Azure.
tableName	path	True	string	Nome della tabella.
api-version	query	True	string	Versione dell'API da usare per la richiesta.

Risposte

Nome	Tipo	Descrizione
200 OK	DatabaseColumn	Colonna del database recuperata correttamente.
Other Status Codes	ErrorResponse	Risposte di errore: 400 UpdateNotAllowedOnPausedDatabase - L'utente ha tentato di eseguire un aggiornamento in un database sospeso. 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato 404 DatabaseDoesNotExist: l'utente ha specificato un nome di database che non esiste in questa istanza del server. 404 SourceDatabaseNotFound - Il database di origine non esiste. 404 ResourceDoesNotExist - Risorsa con il nome '{0}' non esiste. Per continuare, specificare un nome di risorsa valido. 404 InvalidDatabaseSchema - Schema mancante nel database. 404 InvalidDatabaseTable - Tabella mancante nel database. 404 InvalidDatabaseColumn - Colonna mancante nella tabella. 503 DatabaseUnavailable: operazione non riuscita perché il database non è disponibile.

Esempio

Get database column

Esempio di richiesta

HTTP

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=2023-08-01

Risposta di esempio

Codice di stato:

200

{
  "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
  }
}

Definizioni

Nome	Descrizione
ColumnDataType	Tipo di dati della colonna.
DatabaseColumn	Risorsa della colonna di database.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
TableTemporalType	Tipo temporale della tabella.

ColumnDataType

Enumerazione

Tipo di dati della colonna.

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

DatabaseColumn

Oggetto

Risorsa della colonna di database.

Nome	Tipo	Descrizione
id	string	ID risorsa.
name	string	Nome risorsa.
properties.columnType	ColumnDataType	Tipo di dati della colonna.
properties.isComputed	boolean	Indica se la colonna viene calcolata o meno.
properties.memoryOptimized	boolean	Indica se la colonna appartiene o meno a una tabella ottimizzata per la memoria.
properties.temporalType	TableTemporalType	Tipo temporale della tabella.
type	string	Tipo di risorsa.

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

TableTemporalType

Enumerazione

Tipo temporale della tabella.

Valore	Descrizione
NonTemporalTable
HistoryTable
SystemVersionedTemporalTable