Items - Create Mirrored Database

Ссылка

Служба:: MirroredDatabase

Версия API:: v1

Создает зеркальную базу данных в указанной рабочей области.
Этот API не поддерживает создание зеркальной базы данных без определения. Чтобы создать зеркальную базу данных с определением, ознакомьтесь с определении зеркальной базы данных статье.

Разрешения

Вызывающий объект должен иметь участника или более поздней роли рабочей области.

Обязательные делегированные области

MirroredDatabase.ReadWrite.All или Item.ReadWrite.All

Поддерживаемые удостоверения Microsoft Entra

Этот API поддерживает удостоверения Microsoft , перечисленные в этом разделе.

Тождество	Поддержка
Пользователь	Да
субъекта-службы и управляемых удостоверений	Да

Интерфейс

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/mirroredDatabases

Параметры URI

Имя	В	Обязательно	Тип	Описание
workspaceId	path	True	string uuid	Идентификатор рабочей области.

Текст запроса

Имя	Обязательно	Тип	Описание
definition	True	MirroredDatabaseDefinition	Открытое определение зеркальной базы данных.
displayName	True	string	Отображаемое имя зеркальной базы данных. Отображаемое имя должно соответствовать правилам именования в соответствии с типом элемента.
description		string	Описание зеркальной базы данных. Максимальная длина — 256 символов.

Ответы

Имя	Тип	Описание
201 Created	MirroredDatabase	Успешно создано
Other Status Codes	ErrorResponse	Распространенные коды ошибок: InvalidItemType — тип элемента недопустим ItemDisplayNameAlreadyInUse — отображаемое имя элемента уже используется. Поврежденный Payload — предоставленные полезные данные повреждены.

Имя

Тип

Описание

201 Created

MirroredDatabase

Успешно создано

Other Status Codes

ErrorResponse

Распространенные коды ошибок:

InvalidItemType — тип элемента недопустим
ItemDisplayNameAlreadyInUse — отображаемое имя элемента уже используется.
Поврежденный Payload — предоставленные полезные данные повреждены.

Примеры

Create a mirrored database with public definition example

Образец запроса

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/mirroredDatabases

{
  "displayName": "Mirrored database 1",
  "description": "A mirrored database description",
  "definition": {
    "parts": [
      {
        "path": "mirroring.json",
        "payload": "eyAicHJvcGVydGllcy..WJsZSIgfSB9IH0gXSB9IH0",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

Пример ответа

Код состояния:: 201

{
  "displayName": "Mirrored database 1",
  "description": "A mirrored database description",
  "type": "MirroredDatabase",
  "workspaceId": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
  "id": "b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2"
}

Определения

Имя	Описание
CreateMirroredDatabaseRequest	Создайте полезные данные запроса зеркальной базы данных.
ErrorRelatedResource	Объект сведений об ошибках, связанных с ресурсом.
ErrorResponse	Ответ на ошибку.
ErrorResponseDetails	Сведения об ответе на ошибку.
ItemType	Тип элемента. С течением времени могут добавляться дополнительные типы элементов.
MirroredDatabase	Зеркальный элемент базы данных.
MirroredDatabaseDefinition	Объект открытого определения зеркальной базы данных.
MirroredDatabaseDefinitionPart	Объект части определения зеркальной базы данных.
MirroredDatabaseProperties	Свойства зеркальной базы данных.
PayloadType	Тип полезных данных части определения. С течением времени могут добавляться дополнительные типы полезных данных.
SqlEndpointProperties	Объект, содержащий свойства конечной точки SQL.
SqlEndpointProvisioningStatus	Тип состояния подготовки конечной точки SQL. С течением времени могут добавляться дополнительные `SqlEndpointProvisioningStatus` типы.

CreateMirroredDatabaseRequest

Object

Создайте полезные данные запроса зеркальной базы данных.

Имя	Тип	Описание
definition	MirroredDatabaseDefinition	Открытое определение зеркальной базы данных.
description	string	Описание зеркальной базы данных. Максимальная длина — 256 символов.
displayName	string	Отображаемое имя зеркальной базы данных. Отображаемое имя должно соответствовать правилам именования в соответствии с типом элемента.

ErrorRelatedResource

Object

Объект сведений об ошибках, связанных с ресурсом.

Имя	Тип	Описание
resourceId	string	Идентификатор ресурса, участвующий в ошибке.
resourceType	string	Тип ресурса, который участвует в ошибке.

ErrorResponse

Object

Ответ на ошибку.

Имя	Тип	Описание
errorCode	string	Определенный идентификатор, предоставляющий сведения об условии ошибки, что позволяет стандартизировать обмен данными между службой и ее пользователями.
message	string	Удобочитаемое представление ошибки.
moreDetails	ErrorResponseDetails[]	Список дополнительных сведений об ошибке.
relatedResource	ErrorRelatedResource	Сведения об ошибках, связанных с ресурсом.
requestId	string	Идентификатор запроса, связанного с ошибкой.

ErrorResponseDetails

Object

Сведения об ответе на ошибку.

Имя	Тип	Описание
errorCode	string	Определенный идентификатор, предоставляющий сведения об условии ошибки, что позволяет стандартизировать обмен данными между службой и ее пользователями.
message	string	Удобочитаемое представление ошибки.
relatedResource	ErrorRelatedResource	Сведения об ошибках, связанных с ресурсом.

ItemType

Перечисление

Тип элемента. С течением времени могут добавляться дополнительные типы элементов.

Значение	Описание
Dashboard	Панель мониторинга PowerBI.
DataPipeline	Конвейер данных.
Datamart	Datamart PowerBI.
Environment	Среда.
Eventhouse	Хранилище событий.
Eventstream	Поток событий.
GraphQLApi	API для элемента GraphQL.
KQLDashboard	Панель мониторинга KQL.
KQLDatabase	База данных KQL.
KQLQueryset	Набор запросов KQL.
Lakehouse	Озеро.
MLExperiment	Эксперимент машинного обучения.
MLModel	Модель машинного обучения.
MirroredDatabase	Зеркальная база данных.
MirroredWarehouse	Зеркальный склад.
MountedDataFactory	ПодключеннаяdataFactory.
Notebook	Записная книжка.
PaginatedReport	Отчет с разбивкой на страницы PowerBI.
Reflex	Рефлекс.
Report	Отчет PowerBI.
SQLDatabase	База данных SQLDatabase.
SQLEndpoint	Конечная точка SQL.
SemanticModel	Семантическая модель PowerBI.
SparkJobDefinition	Определение задания Spark.
Warehouse	Склад.

MirroredDatabase

Object

Зеркальный элемент базы данных.

Имя	Тип	Описание
description	string	Описание элемента.
displayName	string	Отображаемое имя элемента.
id	string uuid	Идентификатор элемента.
properties	MirroredDatabaseProperties	Свойства зеркальной базы данных.
type	ItemType	Тип элемента.
workspaceId	string uuid	Идентификатор рабочей области.

MirroredDatabaseDefinition

Object

Объект открытого определения зеркальной базы данных.

Имя	Тип	Описание
parts	MirroredDatabaseDefinitionPart[]	Список частей определения.

MirroredDatabaseDefinitionPart

Object

Объект части определения зеркальной базы данных.

Имя	Тип	Описание
path	string	Путь к части зеркальной базы данных.
payload	string	Полезные данные части зеркальной базы данных.
payloadType	PayloadType	Тип полезных данных.

MirroredDatabaseProperties

Object

Свойства зеркальной базы данных.

Имя	Тип	Описание
defaultSchema	string	Схема по умолчанию зеркальной базы данных. Это свойство возвращается только для зеркальной базы данных, которая включает схему по умолчанию в определении.
oneLakeTablesPath	string	Путь OneLake к каталогу зеркальных таблиц баз данных.
sqlEndpointProperties	SqlEndpointProperties	Объект, содержащий свойства конечной точки SQL.

PayloadType

Перечисление

Тип полезных данных части определения. С течением времени могут добавляться дополнительные типы полезных данных.

Значение	Описание
InlineBase64	Встроенная база 64.

SqlEndpointProperties

Object

Объект, содержащий свойства конечной точки SQL.

Имя	Тип	Описание
connectionString	string	Строка подключения конечной точки SQL.
id	string	Идентификатор конечной точки SQL.
provisioningStatus	SqlEndpointProvisioningStatus	Состояние подготовки конечной точки SQL.

SqlEndpointProvisioningStatus

Перечисление

Тип состояния подготовки конечной точки SQL. С течением времени могут добавляться дополнительные SqlEndpointProvisioningStatus типы.

Значение	Описание
Failed	Сбой подготовки конечной точки SQL.
InProgress	Подготовка конечной точки SQL выполняется.
Success	Подготовка конечной точки SQL завершилась успешно.

Поделиться через

Items - Create Mirrored Database

Разрешения

Обязательные делегированные области

Поддерживаемые удостоверения Microsoft Entra

Интерфейс

Параметры URI

Текст запроса

Ответы

Примеры

Create a mirrored database with public definition example

Образец запроса

Пример ответа

Определения

CreateMirroredDatabaseRequest

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ItemType

MirroredDatabase

MirroredDatabaseDefinition

MirroredDatabaseDefinitionPart

MirroredDatabaseProperties

PayloadType

SqlEndpointProperties

SqlEndpointProvisioningStatus

Дополнительные ресурсы