Managed Database Columns - List By Database

Usługa:: SQL Database

Wersja interfejsu API:: 2025-01-01

Wyświetlanie listy kolumn zarządzanych baz danych

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

Z parametrami opcjonalnymi:

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=2025-01-01

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
databaseName	path	True	string	Nazwa bazy danych.
managedInstanceName	path	True	string	Nazwa wystąpienia zarządzanego.
resourceGroupName	path	True	string	Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API usługi Azure Resource Manager lub portalu.
subscriptionId	path	True	string	Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
api-version	query	True	string	Wersja interfejsu API do użycia dla żądania.
$skiptoken	query		string	Nieprzezroczysty token identyfikujący punkt początkowy w kolekcji.
column	query		string[]
orderBy	query		string[]
schema	query		string[]
table	query		string[]

Odpowiedzi

Nazwa	Typ	Opis
200 OK	DatabaseColumnListResult	Pomyślnie pobrano kolumny bazy danych.
Other Status Codes	ErrorResponse	Odpowiedzi na błędy: *** 400 UnsupportedColumnOrderByProperty — właściwość order-by "{0}" nie jest obsługiwana. Dozwolone właściwości to: {1}. 400 UnsupportedColumnSortDirection — kierunek sortowania kolumny "{0}" nie jest obsługiwany. Dozwolone wartości to: {1}. 400 UpdateNotAllowedOnPausedDatabase — użytkownik próbował wykonać aktualizację w wstrzymanej bazie danych. 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera 404 DatabaseDoesNotExist — użytkownik określił nazwę bazy danych, która nie istnieje w tym wystąpieniu serwera. 404 SourceDatabaseNotFound — źródłowa baza danych nie istnieje. 404 ResourceDoesNotExist — zasób o nazwie "{0}" nie istnieje. Aby kontynuować, określ prawidłową nazwę zasobu. 503 DatabaseUnavailable — operacja nie powiodła się, ponieważ baza danych jest niedostępna.

Nazwa

Typ

Opis

200 OK

DatabaseColumnListResult

Pomyślnie pobrano kolumny bazy danych.

Other Status Codes

ErrorResponse

Odpowiedzi na błędy: ***

400 UnsupportedColumnOrderByProperty — właściwość order-by "{0}" nie jest obsługiwana. Dozwolone właściwości to: {1}.
400 UnsupportedColumnSortDirection — kierunek sortowania kolumny "{0}" nie jest obsługiwany. Dozwolone wartości to: {1}.
400 UpdateNotAllowedOnPausedDatabase — użytkownik próbował wykonać aktualizację w wstrzymanej bazie danych.
404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera
404 DatabaseDoesNotExist — użytkownik określił nazwę bazy danych, która nie istnieje w tym wystąpieniu serwera.
404 SourceDatabaseNotFound — źródłowa baza danych nie istnieje.
404 ResourceDoesNotExist — zasób o nazwie "{0}" nie istnieje. Aby kontynuować, określ prawidłową nazwę zasobu.
503 DatabaseUnavailable — operacja nie powiodła się, ponieważ baza danych jest niedostępna.

Przykłady

Filter managed database columns

List managed database columns

Filter managed database columns

Przykładowe żądanie

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=2025-01-01

Przykładowa odpowiedź

Kod stanu:: 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

Przykładowe żądanie

HTTP

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

Przykładowa odpowiedź

Kod stanu:: 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"
    }
  ]
}

Definicje

Nazwa	Opis
ColumnDataType	Typ danych kolumny.
DatabaseColumn	Zasób kolumny bazy danych.
DatabaseColumnListResult	Lista kolumn bazy danych.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
TableTemporalType	Typ czasowy tabeli.

ColumnDataType

Wyliczenie

Typ danych kolumny.

Wartość	Opis
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

Objekt

Zasób kolumny bazy danych.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
name	string	Nazwa zasobu.
properties.columnType	ColumnDataType	Typ danych kolumny.
properties.isComputed	boolean	Określa, czy kolumna jest obliczana.
properties.memoryOptimized	boolean	Określa, czy kolumna należy do tabeli zoptymalizowanej pod kątem pamięci.
properties.temporalType	TableTemporalType	Typ czasowy tabeli.
type	string	Typ zasobu.

DatabaseColumnListResult

Objekt

Lista kolumn bazy danych.

Nazwa	Typ	Opis
nextLink	string	Łącze, aby pobrać następną stronę wyników.
value	DatabaseColumn[]	Tablica wyników.

ErrorAdditionalInfo

Objekt

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Objekt

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Błąd dodatkowe informacje.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Cel błędu.

ErrorResponse

Objekt

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

TableTemporalType

Wyliczenie

Typ czasowy tabeli.

Wartość	Opis
NonTemporalTable
HistoryTable
SystemVersionedTemporalTable