Database Extensions - Create Or Update
执行数据库扩展作,例如数据库导入、数据库导出或 polybase 导入
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/extensions/{extensionName}?api-version=2023-08-01
		URI 参数
| 名称 | 在 | 必需 | 类型 | 说明 | 
|---|---|---|---|---|
| 
						 database 
					 | 
					path | True | 
			 string  | 
					
						 数据库的名称。  | 
				
| 
						 extension 
					 | 
					path | True | 
			 string  | 
					|
| 
						 resource 
					 | 
					path | True | 
			 string  | 
					
						 包含资源的资源组的名称。 可以从 Azure 资源管理器 API 或门户获取此值。  | 
				
| 
						 server 
					 | 
					path | True | 
			 string  | 
					
						 服务器的名称。  | 
				
| 
						 subscription 
					 | 
					path | True | 
			 string  | 
					
						 标识 Azure 订阅的订阅 ID。  | 
				
| 
						 api-version 
					 | 
					query | True | 
			 string  | 
					
						 要用于请求的 API 版本。  | 
				
请求正文
| 名称 | 必需 | 类型 | 说明 | 
|---|---|---|---|
| properties.operationMode | True | 
		 作的作模式:导入、导出或 PolybaseImport。  | 
|
| properties.storageKey | True | 
			 string  | 
	
		 存储帐户的存储密钥。  | 
| properties.storageKeyType | True | 
		 存储密钥类型:StorageAccessKey 或 SharedAccessKey。  | 
|
| properties.storageUri | True | 
			 string  | 
	
		 存储帐户的存储 URI。  | 
| properties.administratorLogin | 
			 string  | 
	
		 管理员登录名。  | 
|
| properties.administratorLoginPassword | 
			 string  | 
	
		 管理员登录密码。  | 
|
| properties.authenticationType | 
			 string  | 
	
		 身份验证类型:SQL 身份验证或 AD 密码。  | 
|
| properties.databaseEdition | 
			 string  | 
	
		 导入作时新建的数据库的数据库版本。  | 
|
| properties.maxSizeBytes | 
			 string  | 
	
		 对于导入作,新创建的数据库的数据库的最大大小(以字节为单位)。  | 
|
| properties.networkIsolation | 
		 用于为请求启用网络隔离的可选资源信息。  | 
||
| properties.serviceObjectiveName | 
			 string  | 
	
		 导入作时新建的数据库的数据库服务级别目标。  | 
响应
| 名称 | 类型 | 说明 | 
|---|---|---|
| 200 OK | 
		 成功完成导入/导出作。  | 
|
| 202 Accepted | 
		 导入/导出作正在进行中。 标头 Location: string  | 
|
| Other Status Codes | 
		 错误响应: *** 
  | 
示例
| Create or Update database extensions. | 
| Export database using database extension. | 
| Import database using database extension. | 
Create or Update database extensions.
示例请求
PUT https://management.azure.com/subscriptions/a1c0814d-3c18-4e1e-a247-c128c12b1677/resourceGroups/rg_20cbe0f0-c2d9-4522-9177-5469aad53029/providers/Microsoft.Sql/servers/srv_1ffd1cf8-9951-47fb-807d-a9c384763849/databases/878e303f-1ea0-4f17-aa3d-a22ac5e9da08/extensions/polybaseimport?api-version=2023-08-01
{
  "properties": {
    "operationMode": "PolybaseImport",
    "storageKeyType": "StorageAccessKey",
    "storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "storageUri": "https://teststorage.blob.core.windows.net/testcontainer/Manifest.xml"
  }
}
示例响应
{
  "properties": {
    "requestId": "10000000-0000-0000-0000-000000000002",
    "requestType": "PolybaseImport",
    "lastModifiedTime": "lastModifiedTime",
    "serverName": "srv_1ffd1cf8-9951-47fb-807d-a9c384763849",
    "databaseName": "878e303f-1ea0-4f17-aa3d-a22ac5e9da08",
    "status": "succeeded"
  },
  "id": "10000000-0000-0000-0000-000000000002",
  "name": "10000000-0000-0000-0000-000000000002",
  "type": "Microsoft.Sql/servers/databases/extensions"
}
				Export database using database extension.
示例请求
PUT https://management.azure.com/subscriptions/0ca8cd24-0b47-4ad5-bc7e-d70e35c44adf/resourceGroups/rg_d1ef9eae-044d-4710-ba59-b82e84ad3157/providers/Microsoft.Sql/servers/srv_9243d320-ac4e-4f97-8e06-b1167dae5f4c/databases/db_7fe424c8-23cf-4ac3-bdc3-e21f424bdb68/extensions/Export?api-version=2023-08-01
{
  "properties": {
    "operationMode": "Export",
    "storageKeyType": "StorageAccessKey",
    "storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "storageUri": "https://teststorage.blob.core.windows.net/testcontainer/Manifest.xml",
    "administratorLogin": "login",
    "administratorLoginPassword": "password",
    "authenticationType": "Sql"
  }
}
示例响应
{
  "properties": {
    "requestId": "10000000-0000-0000-0000-000000000002",
    "requestType": "Export",
    "lastModifiedTime": "lastModifiedTime",
    "serverName": "srv_9243d320-ac4e-4f97-8e06-b1167dae5f4c",
    "databaseName": "db_7fe424c8-23cf-4ac3-bdc3-e21f424bdb68",
    "status": "Completed",
    "queuedTime": "09/10/2021 18:35:10",
    "blobUri": "https://teststorage.blob.core.windows.net/testcontainer/samplebacpac.bacpac",
    "privateEndpointConnections": []
  },
  "id": "10000000-0000-0000-0000-000000000002",
  "name": "10000000-0000-0000-0000-000000000002",
  "type": "Microsoft.Sql/servers/databases/extensions"
}
						
				Import database using database extension.
示例请求
PUT https://management.azure.com/subscriptions/17ca4d13-bf7d-4c33-a60e-b87a2820a325/resourceGroups/rg_062866bf-c4f4-41f9-abf0-b59132ca7924/providers/Microsoft.Sql/servers/srv_2d6be2d2-26c8-4930-8fb6-82a5e95e0e82/databases/db_2a47e946-e414-4c00-94ac-ed886bb78302/extensions/Import?api-version=2023-08-01
{
  "properties": {
    "operationMode": "Import",
    "storageKeyType": "StorageAccessKey",
    "storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "storageUri": "https://teststorage.blob.core.windows.net/testcontainer/Manifest.xml",
    "administratorLogin": "login",
    "administratorLoginPassword": "password",
    "authenticationType": "Sql"
  }
}
示例响应
{
  "properties": {
    "requestId": "10000000-0000-0000-0000-000000000002",
    "requestType": "Import",
    "lastModifiedTime": "lastModifiedTime",
    "serverName": "srv_2d6be2d2-26c8-4930-8fb6-82a5e95e0e82",
    "databaseName": "db_2a47e946-e414-4c00-94ac-ed886bb78302",
    "status": "Completed",
    "queuedTime": "09/10/2021 18:35:10",
    "blobUri": "https://teststorage.blob.core.windows.net/testcontainer/samplebacpac.bacpac",
    "privateEndpointConnections": []
  },
  "id": "10000000-0000-0000-0000-000000000002",
  "name": "10000000-0000-0000-0000-000000000002",
  "type": "Microsoft.Sql/servers/databases/extensions"
}
						
				定义
| 名称 | 说明 | 
|---|---|
| 
							Database | 
						
							 导入、导出或 PolybaseImport 资源。  | 
					
| 
							Error | 
						
							 资源管理错误附加信息。  | 
					
| 
							Error | 
						
							 错误详细信息。  | 
					
| 
							Error | 
						
							 错误响应  | 
					
| 
							Import | 
						
							 扩展作结果资源。  | 
					
| 
							Network | 
						
							 包含要为其创建专用终结点连接的 ARM 资源。  | 
					
| 
							Operation | 
						
							 作的作模式:导入、导出或 PolybaseImport。  | 
					
| 
							Private | 
						
							 包含专用终结点连接请求状态。  | 
					
| 
							Storage | 
						
							 存储密钥类型:StorageAccessKey 或 SharedAccessKey。  | 
					
DatabaseExtensions 
			
			导入、导出或 PolybaseImport 资源。
| 名称 | 类型 | 说明 | 
|---|---|---|
| id | 
			 string  | 
	
		 资源 ID。  | 
| name | 
			 string  | 
	
		 资源名称。  | 
| properties.administratorLogin | 
			 string  | 
	
		 管理员登录名。  | 
| properties.administratorLoginPassword | 
			 string  | 
	
		 管理员登录密码。  | 
| properties.authenticationType | 
			 string  | 
	
		 身份验证类型:SQL 身份验证或 AD 密码。  | 
| properties.databaseEdition | 
			 string  | 
	
		 导入作时新建的数据库的数据库版本。  | 
| properties.maxSizeBytes | 
			 string  | 
	
		 对于导入作,新创建的数据库的数据库的最大大小(以字节为单位)。  | 
| properties.networkIsolation | 
		 用于为请求启用网络隔离的可选资源信息。  | 
|
| properties.operationMode | 
		 作的作模式:导入、导出或 PolybaseImport。  | 
|
| properties.serviceObjectiveName | 
			 string  | 
	
		 导入作时新建的数据库的数据库服务级别目标。  | 
| properties.storageKey | 
			 string  | 
	
		 存储帐户的存储密钥。  | 
| properties.storageKeyType | 
		 存储密钥类型:StorageAccessKey 或 SharedAccessKey。  | 
|
| properties.storageUri | 
			 string  | 
	
		 存储帐户的存储 URI。  | 
| type | 
			 string  | 
	
		 资源类型。  | 
ErrorAdditionalInfo  
			
			资源管理错误附加信息。
| 名称 | 类型 | 说明 | 
|---|---|---|
| info | 
			 object  | 
	
		 其他信息。  | 
| type | 
			 string  | 
	
		 其他信息类型。  | 
ErrorDetail 
			
			错误详细信息。
| 名称 | 类型 | 说明 | 
|---|---|---|
| additionalInfo | 
		 错误附加信息。  | 
|
| code | 
			 string  | 
	
		 错误代码。  | 
| details | 
		 错误详细信息。  | 
|
| message | 
			 string  | 
	
		 错误消息。  | 
| target | 
			 string  | 
	
		 错误目标。  | 
ErrorResponse 
			
			错误响应
| 名称 | 类型 | 说明 | 
|---|---|---|
| error | 
		 错误对象。  | 
ImportExportExtensionsOperationResult    
			
			扩展作结果资源。
| 名称 | 类型 | 说明 | 
|---|---|---|
| id | 
			 string  | 
	
		 资源 ID。  | 
| name | 
			 string  | 
	
		 资源名称。  | 
| properties.blobUri | 
			 string  | 
	
		 Blob URI。  | 
| properties.databaseName | 
			 string  | 
	
		 数据库名称。  | 
| properties.errorMessage | 
			 string  | 
	
		 错误信息。  | 
| properties.lastModifiedTime | 
			 string  | 
	
		 上次修改时间。  | 
| properties.privateEndpointConnections | 
		 获取与此请求关联的专用终结点的状态。  | 
|
| properties.queuedTime | 
			 string  | 
	
		 排队时间。  | 
| properties.requestId | 
			 string (uuid)  | 
	
		 请求 ID。  | 
| properties.requestType | 
			 string  | 
	
		 请求类型。  | 
| properties.serverName | 
			 string  | 
	
		 服务器名称。  | 
| properties.status | 
			 string  | 
	
		 作状态。  | 
| type | 
			 string  | 
	
		 资源类型。  | 
NetworkIsolationSettings  
			
			包含要为其创建专用终结点连接的 ARM 资源。
| 名称 | 类型 | 说明 | 
|---|---|---|
| sqlServerResourceId | 
			 string (arm-id)  | 
	
		 SQL Server 的资源 ID,这是此请求的目标。 如果设置,将为 SQL Server 创建专用终结点连接。 必须与作的目标服务器匹配。  | 
| storageAccountResourceId | 
			 string (arm-id)  | 
	
		 用于存储 BACPAC 文件的存储帐户的资源 ID。 如果设置,将为存储帐户创建专用终结点连接。 必须与用于 StorageUri 参数的存储帐户匹配。  | 
OperationMode 
			
			作的作模式:导入、导出或 PolybaseImport。
| 值 | 说明 | 
|---|---|
| PolybaseImport | |
| Import | |
| Export | 
PrivateEndpointConnectionRequestStatus    
			
			包含专用终结点连接请求状态。
| 名称 | 类型 | 说明 | 
|---|---|---|
| privateEndpointConnectionName | 
			 string  | 
	
		 专用终结点的连接名称。  | 
| privateLinkServiceId | 
			 string  | 
	
		 为其创建专用终结点的资源 ID。  | 
| status | 
			 string  | 
	
		 此专用终结点连接的状态。  | 
StorageKeyType  
			
			存储密钥类型:StorageAccessKey 或 SharedAccessKey。
| 值 | 说明 | 
|---|---|
| SharedAccessKey | |
| StorageAccessKey |