你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Managed Database Columns - List By Database

参考

Service:: SQL Database

API Version:: 2021-11-01

列出托管数据库列

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

With optional parameters:

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=2021-11-01

URI 参数

名称	在	必需	类型	说明
databaseName	path	True	string	数据库的名称。
managedInstanceName	path	True	string	托管实例的名称。
resourceGroupName	path	True	string	包含该资源的资源组名称。可以从 Azure 资源管理器 API 或门户获取此值。
subscriptionId	path	True	string	用于标识 Azure 订阅的订阅 ID。
api-version	query	True	string	要用于请求的 API 版本。
$skiptoken	query		string	一个不透明标记，用于标识集合中的起点。
column	query		string[]
orderBy	query		string[]
schema	query		string[]
table	query		string[]

响应

名称	类型	说明
200 OK	DatabaseColumnListResult	已成功检索数据库列。
Other Status Codes		错误响应： *** 400 UnsupportedColumnOrderByProperty - 不支持 order-by 属性“{0}”。允许的属性为： {1}。 400 UnsupportedColumnSortDirection - 不支持列排序方向“{0}”。允许值包括：{1}。 400 UpdateNotAllowedOnPausedDatabase - 用户尝试对暂停的数据库执行更新。 404 SubscriptionDoesNotHaveServer - 找不到请求的服务器 404 SourceDatabaseNotFound - 源数据库不存在。 404 DatabaseDoesNotExist - 用户指定了此服务器实例上不存在的数据库名称。 404 ResourceDoesNotExist - 名称为“”{0}的资源不存在。若要继续，请指定有效的资源名称。 503 DatabaseUnavailable - 操作失败，因为数据库不可用。

名称

类型

说明

200 OK

DatabaseColumnListResult

已成功检索数据库列。

Other Status Codes

错误响应： ***

400 UnsupportedColumnOrderByProperty - 不支持 order-by 属性“{0}”。允许的属性为： {1}。
400 UnsupportedColumnSortDirection - 不支持列排序方向“{0}”。允许值包括：{1}。
400 UpdateNotAllowedOnPausedDatabase - 用户尝试对暂停的数据库执行更新。
404 SubscriptionDoesNotHaveServer - 找不到请求的服务器
404 SourceDatabaseNotFound - 源数据库不存在。
404 DatabaseDoesNotExist - 用户指定了此服务器实例上不存在的数据库名称。
404 ResourceDoesNotExist - 名称为“”{0}的资源不存在。若要继续，请指定有效的资源名称。
503 DatabaseUnavailable - 操作失败，因为数据库不可用。

示例

Filter managed database columns

List managed database columns

Filter managed database columns

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=2021-11-01


import com.azure.core.util.Context;
import java.util.Arrays;

/** Samples for ManagedDatabaseColumns ListByDatabase. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedColumnsListByDatabaseMax.json
     */
    /**
     * Sample code: Filter managed database columns.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void filterManagedDatabaseColumns(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabaseColumns().listByDatabase("myRG", "serverName",
            "myDatabase", Arrays.asList("dbo"), Arrays.asList("customer", "address"), Arrays.asList("username"),
            Arrays.asList("schema asc", "table", "column desc"), null, 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

Sample Response

Status code:: 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

Sample Request

HTTP
Java

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


import com.azure.core.util.Context;

/** Samples for ManagedDatabaseColumns ListByDatabase. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedColumnsListByDatabaseMin.json
     */
    /**
     * Sample code: List managed database columns.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void listManagedDatabaseColumns(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabaseColumns().listByDatabase("myRG", "serverName",
            "myDatabase", null, null, null, null, null, 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

Sample Response

Status code:: 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"
    }
  ]
}

定义

名称	说明
ColumnDataType	列数据类型。
DatabaseColumn	数据库列资源。
DatabaseColumnListResult	数据库列的列表。
TableTemporalType	表时态类型。

ColumnDataType

列数据类型。

名称	类型	说明
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

数据库列资源。

名称	类型	说明
id	string	资源 ID。
name	string	资源名称。
properties.columnType	ColumnDataType	列数据类型。
properties.isComputed	boolean	是否计算列。
properties.memoryOptimized	boolean	该列是否属于内存优化表。
properties.temporalType	TableTemporalType	表时态类型。
type	string	资源类型。

DatabaseColumnListResult

数据库列的列表。

名称	类型	说明
nextLink	string	用于检索下一页结果的链接。
value	DatabaseColumn[]	结果数组。

TableTemporalType

表时态类型。

名称	类型	说明
HistoryTable	string
NonTemporalTable	string
SystemVersionedTemporalTable	string

Managed Database Columns - List By Database

URI 参数

响应

示例

Filter managed database columns

Sample Request

Sample Response

List managed database columns

Sample Request

Sample Response

定义

ColumnDataType

DatabaseColumn

DatabaseColumnListResult

TableTemporalType

其他资源