Database Columns - List By Database

Reference

Služba:: SQL Database

Verze rozhraní API:: 2021-11-01

Výpis sloupců databáze

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

S volitelnými parametry:

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
databaseName	path	True	string	Název databáze.
resourceGroupName	path	True	string	Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API azure Resource Manager nebo z portálu.
serverName	path	True	string	Název serveru.
subscriptionId	path	True	string	ID předplatného, které identifikuje předplatné Azure.
api-version	query	True	string	Verze rozhraní API, která se má použít pro požadavek.
$skiptoken	query		string	Neprůshlený token, který identifikuje výchozí bod v kolekci.
column	query		string[]
orderBy	query		string[]
schema	query		string[]
table	query		string[]

Odpovědi

Name	Typ	Description
200 OK	DatabaseColumnListResult	Sloupce databáze se úspěšně načetly.
Other Status Codes		Chybové odpovědi: *** 400 UnsupportedColumnOrderByProperty – vlastnost{0} order-by není podporována. Povolené vlastnosti jsou: {1}. 400 UnsupportedColumnSortDirection – směr{0} řazení sloupců není podporován. Povolené hodnoty jsou: {1}. 400 UpdateNotAllowedOnPausedDatabase – uživatel se pokusil provést aktualizaci pozastavené databáze. 404 SubscriptionDoesNotHaveServer – požadovaný server nebyl nalezen. 404 SourceDatabaseNotFound – zdrojová databáze neexistuje. 404 DatabaseDoesNotExist – Uživatel zadal název databáze, který na této instanci serveru neexistuje. 404 ResourceDoesNotExist – prostředek s názvem{0} neexistuje. Pokud chcete pokračovat, zadejte platný název prostředku. 503 DatabaseUnavailable – operace selhala, protože databáze není k dispozici.

Name

Typ

Description

200 OK

DatabaseColumnListResult

Sloupce databáze se úspěšně načetly.

Other Status Codes

Chybové odpovědi: ***

400 UnsupportedColumnOrderByProperty – vlastnost{0} order-by není podporována. Povolené vlastnosti jsou: {1}.
400 UnsupportedColumnSortDirection – směr{0} řazení sloupců není podporován. Povolené hodnoty jsou: {1}.
400 UpdateNotAllowedOnPausedDatabase – uživatel se pokusil provést aktualizaci pozastavené databáze.
404 SubscriptionDoesNotHaveServer – požadovaný server nebyl nalezen.
404 SourceDatabaseNotFound – zdrojová databáze neexistuje.
404 DatabaseDoesNotExist – Uživatel zadal název databáze, který na této instanci serveru neexistuje.
404 ResourceDoesNotExist – prostředek s názvem{0} neexistuje. Pokud chcete pokračovat, zadejte platný název prostředku.
503 DatabaseUnavailable – operace selhala, protože databáze není k dispozici.

Příklady

Filter database columns

List database columns

Filter database columns

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


import java.util.Arrays;

/**
 * Samples for DatabaseColumns ListByDatabase.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ColumnsListByDatabaseMax.json
     */
    /**
     * Sample code: Filter database columns.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void filterDatabaseColumns(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabaseColumns().listByDatabase("myRG", "serverName",
            "myDatabase", Arrays.asList("dbo"), Arrays.asList("customer", "address"), Arrays.asList("username"),
            Arrays.asList("schema asc", "table", "column desc"), null, com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Ukázková odpověď

Stavový kód:: 200

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

List database columns

Ukázkový požadavek

HTTP
Java

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


/**
 * Samples for DatabaseColumns ListByDatabase.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ColumnsListByDatabaseMin.json
     */
    /**
     * Sample code: List database columns.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void listDatabaseColumns(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabaseColumns().listByDatabase("myRG", "serverName",
            "myDatabase", null, null, null, null, null, com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Ukázková odpověď

Stavový kód:: 200

{
  "value": [
    {
      "properties": {
        "columnType": "int",
        "temporalType": "NonTemporalTable",
        "memoryOptimized": false,
        "isComputed": false
      },
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/servers/serverName/databases/myDatabase/schemas/dbo/tables/table1/columns/col1",
      "name": "col1",
      "type": "Microsoft.Sql/servers/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/servers/serverName/databases/myDatabase/schemas/dbo/tables/table1/columns/col2",
      "name": "col2",
      "type": "Microsoft.Sql/servers/databases/schemas/tables/columns"
    }
  ]
}

Definice

Name	Description
ColumnDataType	Datový typ sloupce.
DatabaseColumn	Prostředek sloupce databáze.
DatabaseColumnListResult	Seznam sloupců databáze.
TableTemporalType	Dočasný typ tabulky.

ColumnDataType

Datový typ sloupce.

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

DatabaseColumn

Prostředek sloupce databáze.

Name	Typ	Description
id	string	ID prostředku.
name	string	Název prostředku.
properties.columnType	ColumnDataType	Datový typ sloupce.
properties.isComputed	boolean	Určuje, jestli se sloupec vypočítá.
properties.memoryOptimized	boolean	Určuje, jestli sloupec patří do tabulky optimalizované pro paměť.
properties.temporalType	TableTemporalType	Dočasný typ tabulky.
type	string	Typ prostředku.

DatabaseColumnListResult

Seznam sloupců databáze.

Name	Typ	Description
nextLink	string	Odkaz na načtení další stránky výsledků
value	DatabaseColumn[]	Pole výsledků

TableTemporalType

Dočasný typ tabulky.

Name	Typ	Description
HistoryTable	string
NonTemporalTable	string
SystemVersionedTemporalTable	string

Sdílet prostřednictvím

Database Columns - List By Database

Parametry identifikátoru URI

Odpovědi

Příklady

Filter database columns

Ukázkový požadavek

Ukázková odpověď

List database columns

Ukázkový požadavek

Ukázková odpověď

Definice

ColumnDataType

DatabaseColumn

DatabaseColumnListResult

TableTemporalType

Další materiály