Managed Database Columns - List By Database

Servizio:

SQL Database

Versione API:

2023-08-01

Elencare le colonne del database gestito

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}/columns?api-version=2023-08-01

Con parametri facoltativi:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}/columns?schema={schema}&table={table}&column={column}&orderBy={orderBy}&$skiptoken={$skiptoken}&api-version=2023-08-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
databaseName	path	True	string	Nome del database.
managedInstanceName	path	True	string	Nome dell'istanza gestita.
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.
subscriptionId	path	True	string	ID sottoscrizione che identifica una sottoscrizione di Azure.
api-version	query	True	string	Versione dell'API da usare per la richiesta.
$skiptoken	query		string	Token opaco che identifica un punto iniziale nella raccolta.
column	query		string[]
orderBy	query		string[]
schema	query		string[]
table	query		string[]

Risposte

Nome	Tipo	Descrizione
200 OK	DatabaseColumnListResult	Colonne di database recuperate correttamente.
Other Status Codes	ErrorResponse	Risposte di errore: 400 UnsupportedColumnOrderByProperty - La proprietà order-by '{0}' non è supportata. Le proprietà consentite sono: {1}. 400 UnsupportedColumnSortDirection : la direzione di ordinamento della colonna '{0}' non è supportata. I valori consentiti sono: {1}. 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. 503 DatabaseUnavailable: operazione non riuscita perché il database non è disponibile.

Esempio

Filter managed database columns

List managed database columns

Filter managed database columns

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/managedInstances/serverName/databases/myDatabase/columns?schema=dbo&table=customer&table=address&column=username&orderBy=schema asc&orderBy=table&orderBy=column desc&api-version=2023-08-01

Risposta di esempio

Codice di stato:

200

{
  "value": [
    {
      "properties": {
        "columnType": "nvarchar",
        "temporalType": "NonTemporalTable",
        "memoryOptimized": false,
        "isComputed": false
      },
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/managedInstances/serverName/databases/myDatabase/schemas/dbo/tables/customer/columns/username",
      "name": "username",
      "type": "Microsoft.Sql/managedInstances/databases/schemas/tables/columns"
    }
  ]
}

List managed database columns

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/managedInstances/serverName/databases/myDatabase/columns?api-version=2023-08-01

Risposta di esempio

Codice di stato:

200

{
  "value": [
    {
      "properties": {
        "columnType": "int",
        "temporalType": "NonTemporalTable",
        "memoryOptimized": false,
        "isComputed": false
      },
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/managedInstances/serverName/databases/myDatabase/schemas/dbo/tables/table1/columns/col1",
      "name": "col1",
      "type": "Microsoft.Sql/managedInstances/databases/schemas/tables/columns"
    },
    {
      "properties": {
        "columnType": "bit",
        "temporalType": "SystemVersionedTemporalTable",
        "memoryOptimized": false,
        "isComputed": false
      },
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/managedInstances/serverName/databases/myDatabase/schemas/dbo/tables/table1/columns/col2",
      "name": "col2",
      "type": "Microsoft.Sql/managedInstances/databases/schemas/tables/columns"
    }
  ]
}

Definizioni

Nome	Descrizione
ColumnDataType	Tipo di dati della colonna.
DatabaseColumn	Risorsa della colonna di database.
DatabaseColumnListResult	Elenco di colonne 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.

DatabaseColumnListResult

Oggetto

Elenco di colonne di database.

Nome	Tipo	Descrizione
nextLink	string	Collegamento per recuperare la pagina successiva dei risultati.
value	DatabaseColumn[]	Matrice di risultati.

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