Items - Get Mirrored Database

Служба:: MirroredDatabase

Версия API:: v1

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

Разрешения

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

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

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

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

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

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

Интерфейс

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

Параметры URI

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

Ответы

Имя	Тип	Описание
200 OK	MirroredDatabase	Запрос успешно завершен.
Other Status Codes	ErrorResponse	Распространенные коды ошибок: ItemNotFound — запрошенный элемент не найден.

Имя

Тип

Описание

200 OK

MirroredDatabase

Запрос успешно завершен.

Other Status Codes

ErrorResponse

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

ItemNotFound — запрошенный элемент не найден.

Примеры

Get a mirrored database example

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

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/mirroredDatabases/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2

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

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

{
  "displayName": "Mirrored database 1",
  "description": "A mirrored database description.",
  "type": "MirroredDatabase",
  "workspaceId": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
  "id": "b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2",
  "properties": {
    "oneLakeTablesPath": "https://onelake.dfs.fabric.microsoft.com/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2/Tables",
    "sqlEndpointProperties": {
      "connectionString": "xxx.datawarehouse.fabric.microsoft.com",
      "id": "c2c2c2c2-dddd-eeee-ffff-a3a3a3a3a3a3",
      "provisioningStatus": "Success"
    },
    "defaultSchema": "dbo"
  }
}

Определения

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

ErrorRelatedResource

Объект

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

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

ErrorResponse

Объект

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

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

ErrorResponseDetails

Объект

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

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

ItemTag

Объект

Представляет тег, примененный к элементу.

Имя	Тип	Описание
displayName	string	Имя тега.
id	string (uuid)	Идентификатор тега.

ItemType

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

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

Значение	Описание
Dashboard	Панель мониторинга PowerBI.
Report	Отчет PowerBI.
SemanticModel	Семантическая модель PowerBI.
PaginatedReport	Отчет с разбивкой на страницы PowerBI.
Datamart	Datamart PowerBI.
Lakehouse	Озеро.
Eventhouse	Хранилище событий.
Environment	Среда.
KQLDatabase	База данных KQL.
KQLQueryset	Набор запросов KQL.
KQLDashboard	Панель мониторинга KQL.
DataPipeline	Конвейер данных.
Notebook	Записная книжка.
SparkJobDefinition	Определение задания Spark.
MLExperiment	Эксперимент машинного обучения.
MLModel	Модель машинного обучения.
Warehouse	Склад.
Eventstream	Поток событий.
SQLEndpoint	Конечная точка SQL.
MirroredWarehouse	Зеркальный склад.
MirroredDatabase	Зеркальная база данных.
Reflex	Рефлекс.
GraphQLApi	API для элемента GraphQL.
MountedDataFactory	ПодключеннаяdataFactory.
SQLDatabase	База данных SQLDatabase.
CopyJob	Задание копирования.
VariableLibrary	ПеременнаяLibrary.
Dataflow	Поток данных.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	Моментальный снимок хранилища.
DigitalTwinBuilder	A DigitalTwinBuilder.
DigitalTwinBuilderFlow	Поток Конструктора цифровых двойников.
MirroredAzureDatabricksCatalog	Зеркальный каталог azure databricks.
Map	Карта.
AnomalyDetector	Детектор аномалий.
UserDataFunction	Функция данных пользователя.
GraphModel	A GraphModel.
GraphQuerySet	Набор запросов Graph.
SnowflakeDatabase	База данных Snowflake для хранения таблиц Iceberg, созданных из учетной записи Snowflake.
OperationsAgent	A OperationsAgent.
CosmosDBDatabase	База данных Cosmos DB.
Ontology	An Ontology.
EventSchemaSet	An EventSchemaSet.

MirroredDatabase

Объект

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

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

MirroredDatabaseProperties

Объект

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

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

SqlEndpointProperties

Объект

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

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

SqlEndpointProvisioningStatus

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

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

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

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

Items - Get Mirrored Database

Разрешения

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

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

Интерфейс

Параметры URI

Ответы

Примеры

Get a mirrored database example

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

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

Определения

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ItemTag

ItemType

MirroredDatabase

MirroredDatabaseProperties

SqlEndpointProperties

SqlEndpointProvisioningStatus