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

Mirroring - Get Tables Mirroring Status

Служба:
MirroredDatabase
Версия API:
v1

Получение состояния зеркального отображения таблиц.
Этот API поддерживает разбивки на страницы.

Разрешения

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

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

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

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

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

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

Интерфейс

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/mirroredDatabases/{mirroredDatabaseId}/getTablesMirroringStatus
С использованием необязательных параметров: 
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/mirroredDatabases/{mirroredDatabaseId}/getTablesMirroringStatus?continuationToken={continuationToken}

Параметры URI

Имя В Обязательно Тип Описание
mirroredDatabaseId
 path True

string (uuid)

Идентификатор зеркальной базы данных.
workspaceId
 path True

string (uuid)

Идентификатор рабочей области.
continuationToken
 query

string

Маркер получения следующей страницы результатов.

Ответы

Имя Тип Описание
200 OK

TablesMirroringStatusResponse

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

ErrorResponse

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

  • UnknownError — произошла ошибка.

Примеры

Get tables mirroring status example

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

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

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

Код состояния:
200 
{
  "data": [
    {
      "sourceObjectType": "Table",
      "sourceSchemaName": "dbo",
      "sourceTableName": "test",
      "status": "Replicating",
      "metrics": {
        "processedBytes": 1247,
        "processedRows": 6,
        "lastSyncDateTime": "2024-10-08T05:07:11.0663362Z"
      }
    }
  ]
}

Определения

Имя Описание
ErrorRelatedResource

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

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

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

Метрики зеркального отображения таблиц.
TableMirroringStatus

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

Ответ состояния зеркального отображения таблицы.
TablesMirroringStatusResponse

Список состояний зеркального отображения таблицы с разбивкой на страницы.
TableSourceObjectType

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

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

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

TableMirroringMetrics

Object

Метрики зеркального отображения таблиц.

Имя Тип Описание
lastSyncDateTime

string (date-time)

Время последней обработки таблицы в формате UTC с использованием формата ГГГГ-ММ-ДДTHH:мм:ссЗ.
processedBytes

integer (int64)

Обработанные байты для этой таблицы.
processedRows

integer (int64)

Обработанное число строк для этой таблицы.

TableMirroringStatus

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

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

Значение Описание
Initialized

Мирроинг таблицы инициализирован.
Snapshotting

Таблица выполняет моментальный снимок.
Replicating

Таблица реплицируется.
Reseeding

Таблица переопределена.
Stopped

Зеркальное отображение таблицы остановлено.
Failed

Сбой мирроинга таблицы с ошибкой.

TableMirroringStatusResponse

Object

Ответ состояния зеркального отображения таблицы.

Имя Тип Описание
error

ErrorResponse

Ошибка уровня таблицы устанавливается, если ошибка возникает при зеркальном отображении для этой таблицы
metrics

TableMirroringMetrics

Метрики зеркального отображения таблицы.
sourceObjectType

TableSourceObjectType

Тип исходного объекта.
sourceSchemaName

string

Имя схемы исходной таблицы.
sourceTableName

string

Имя исходной таблицы.
status

TableMirroringStatus

Тип состояния зеркального отображения таблицы.

TablesMirroringStatusResponse

Object

Список состояний зеркального отображения таблицы с разбивкой на страницы.

Имя Тип Описание
continuationToken

string

Маркер для следующего пакета результирующих наборов. Если больше записей нет, он удаляется из ответа.
continuationUri

string

Универсальный код ресурса (URI) следующего пакета результирующих наборов. Если больше записей нет, он удаляется из ответа.
data

TableMirroringStatusResponse[]

Список состояний зеркального отображения таблицы.

TableSourceObjectType

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

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

Значение Описание
Table

Тип таблицы
View

Тип представления