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

Kusto Pool Databases - Create Or Update

创建或更新数据库。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Synapse/workspaces/{workspaceName}/kustoPools/{kustoPoolName}/databases/{databaseName}?api-version=2021-06-01-preview

URI 参数

名称 必需 类型 说明
databaseName
path True

string

Kusto 池中数据库的名称。

kustoPoolName
path True

string

Kusto 池的名称。

resourceGroupName
path True

string

资源组的名称。 此名称不区分大小写。

subscriptionId
path True

string

目标订阅的 ID。

workspaceName
path True

string

工作区的名称。

api-version
query True

string

要用于此操作的 API 版本。

请求正文

请求正文可以为下列任一内容:

名称 说明
ReadOnlyFollowingDatabase

表示只读以下数据库的类。

ReadWriteDatabase

表示读写数据库的类。

ReadOnlyFollowingDatabase

表示只读以下数据库的类。

名称 必需 类型 说明
kind True string:

ReadOnlyFollowing

数据库的种类

location

string

资源位置。

properties.hotCachePeriod

string

数据应在缓存中保留的时间,以便在 TimeSpan 中快速查询。

ReadWriteDatabase

表示读写数据库的类。

名称 必需 类型 说明
kind True string:

ReadWrite

数据库的种类

location

string

资源位置。

properties.hotCachePeriod

string

数据应在缓存中保留的时间,以便在 TimeSpan 中快速查询。

properties.softDeletePeriod

string

数据在停止可供 TimeSpan 中的查询访问之前应保留的时间。

响应

名称 类型 说明
200 OK Database:

没问题。

201 Created Database:

Created.

Other Status Codes

ErrorResponse

描述操作失败原因的错误响应。

示例

KustoPoolDatabasesCreateOrUpdate

示例请求

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Synapse/workspaces/synapseWorkspaceName/kustoPools/kustoclusterrptest4/databases/KustoDatabase8?api-version=2021-06-01-preview

{
  "location": "westus",
  "kind": "ReadWrite",
  "properties": {
    "softDeletePeriod": "P1D"
  }
}

示例响应

{
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Synapse/workspaces/synapseWorkspaceName/kustopools/KustoClusterRPTest4/Databases/KustoDatabase8",
  "name": "KustoClusterRPTest4/KustoDatabase8",
  "type": "Microsoft.Synapse/workspaces/kustopools/Databases",
  "kind": "ReadWrite",
  "location": "westus",
  "properties": {
    "softDeletePeriod": "P1D",
    "provisioningState": "Succeeded"
  }
}
{
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Synapse/workspaces/synapseWorkspaceName/kustopools/KustoClusterRPTest4/Databases/KustoDatabase8",
  "name": "KustoClusterRPTest4/KustoDatabase8",
  "type": "Microsoft.Synapse/workspaces/kustopools/Databases",
  "location": "westus",
  "kind": "ReadWrite",
  "properties": {
    "softDeletePeriod": "P1D",
    "provisioningState": "Succeeded"
  }
}

定义

名称 说明
createdByType

创建资源的标识类型。

DatabaseStatistics

一个包含数据库统计信息的类。

ErrorAdditionalInfo

资源管理错误附加信息。

ErrorDetail

错误详细信息。

ErrorResponse

错误响应

PrincipalsModificationKind

数据库的主体修改类型

ReadOnlyFollowingDatabase

表示只读以下数据库的类。

ReadWriteDatabase

表示读写数据库的类。

ResourceProvisioningState

资源的预配状态。

systemData

与资源的创建和上次修改相关的元数据。

createdByType

创建资源的标识类型。

名称 类型 说明
Application

string

Key

string

ManagedIdentity

string

User

string

DatabaseStatistics

一个包含数据库统计信息的类。

名称 类型 说明
size

number

数据库大小 - 压缩数据和索引的总大小(以字节为单位)。

ErrorAdditionalInfo

资源管理错误附加信息。

名称 类型 说明
info

object

其他信息。

type

string

其他信息类型。

ErrorDetail

错误详细信息。

名称 类型 说明
additionalInfo

ErrorAdditionalInfo[]

错误附加信息。

code

string

错误代码。

details

ErrorDetail[]

错误详细信息。

message

string

错误消息。

target

string

错误目标。

ErrorResponse

错误响应

名称 类型 说明
error

ErrorDetail

错误对象。

PrincipalsModificationKind

数据库的主体修改类型

名称 类型 说明
None

string

Replace

string

Union

string

ReadOnlyFollowingDatabase

表示只读以下数据库的类。

名称 类型 说明
id

string

资源的完全限定的资源 ID。 例如 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

kind string:

ReadOnlyFollowing

数据库的种类

location

string

资源位置。

name

string

资源的名称

properties.attachedDatabaseConfigurationName

string

附加的数据库配置群集的名称

properties.hotCachePeriod

string

数据应在缓存中保留的时间,以便在 TimeSpan 中快速查询。

properties.leaderClusterResourceId

string

前导群集的名称

properties.principalsModificationKind

PrincipalsModificationKind

数据库的主体修改类型

properties.provisioningState

ResourceProvisioningState

资源的预配状态。

properties.softDeletePeriod

string

数据在停止可供 TimeSpan 中的查询访问之前应保留的时间。

properties.statistics

DatabaseStatistics

数据库的统计信息。

systemData

systemData

包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。

type

string

资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

ReadWriteDatabase

表示读写数据库的类。

名称 类型 说明
id

string

资源的完全限定的资源 ID。 例如 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

kind string:

ReadWrite

数据库的种类

location

string

资源位置。

name

string

资源的名称

properties.hotCachePeriod

string

数据应在缓存中保留的时间,以便在 TimeSpan 中快速查询。

properties.isFollowed

boolean

指示是否遵循数据库。

properties.provisioningState

ResourceProvisioningState

资源的预配状态。

properties.softDeletePeriod

string

数据在停止可供 TimeSpan 中的查询访问之前应保留的时间。

properties.statistics

DatabaseStatistics

数据库的统计信息。

systemData

systemData

包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。

type

string

资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

ResourceProvisioningState

资源的预配状态。

名称 类型 说明
Canceled

string

Creating

string

Deleting

string

Failed

string

Moving

string

Running

string

Succeeded

string

systemData

与资源的创建和上次修改相关的元数据。

名称 类型 说明
createdAt

string

资源的创建时间戳 (UTC) 。

createdBy

string

创建资源的标识。

createdByType

createdByType

创建资源的标识类型。

lastModifiedAt

string

资源上次修改的时间戳 (UTC)

lastModifiedBy

string

上次修改资源的标识。

lastModifiedByType

createdByType

上次修改资源的标识类型。