Определение зеркального каталога

В этой статье представлена разбивка структуры определения для элементов зеркального каталога. Зеркальный каталог зеркально отражает таблицы из внешнего поставщика API REST Каталога Iceberg (IRC) в Fabric путем создания делегированных сочетаний клавиш к хранилищу поставщика. Метаданные зеркально отображаются; данные не копируются.

Поддерживаемые форматы

Элементы зеркального каталога поддерживают следующий формат:

  • MirroredCatalogDefinition

Части определения

В этой таблице перечислены части определения зеркального каталога.

Путь к части определения Тип Обязательный Description
MirroredCatalogDefinition.json MirroredCatalogDefinition (JSON) истина Конфигурация зеркального каталога, включая исходное подключение, область и необязательные фильтры таблиц.
.platform PlatformDetails (JSON) false Описание общих сведений об элементе.

Пример определения

Ниже приведен пример определения элемента для зеркального каталога:

{
  "displayName": "myMirroredCatalog",
  "type": "MirroredCatalog",
  "description": "Mirror selected schemas and tables",
  "definition": {
    "format": "MirroredCatalogDefinition",
    "parts": [
      {
        "path": "MirroredCatalogDefinition.json",
        "payload": "eyIkc2NoZW1hIjoiaHR0cHM6Ly9kZXZlbG9wZXIubWljcm9zb2Z0LmNvbS9qc29uLXNjaGVtYXMvZmFicmljL2l0ZW0vbWlycm9yZWRDYXRhbG9nL2RlZmluaXRpb24vbWlycm9yZWRDYXRhbG9nRGVmaW5pdGlvbi8xLjAuMC9zY2hlbWEuanNvbiIsInByb3BlcnRpZXMiOnsic291cmNlIjp7InR5cGUiOiJEcmVtaW9JY2ViZXJnQ2F0YWxvZyIsInR5cGVQcm9wZXJ0aWVzIjp7ImNvbm5lY3Rpb25JZCI6IjRlYjZiNzY3LWU3ODYtNDVlZC1iN2NmLWQyNTAyM2U1MjIyMiIsInNjb3BlIjpbIkFjY291bnRpbmciLCJVUyJdfX0sIm1vdW50ZWRUYWJsZXMiOlt7InNvdXJjZSI6eyJ0eXBlUHJvcGVydGllcyI6eyJmdWxseVF1YWxpZmllZFNjb3BlIjpbIkFjY291bnRpbmciLCJVUyIsIlRheGVzIl0sInRhYmxlTmFtZSI6IlRheEluZm8ifX19LHsic291cmNlIjp7InR5cGVQcm9wZXJ0aWVzIjp7ImZ1bGx5UXVhbGlmaWVkU2NvcGUiOlsiQWNjb3VudGluZyIsIlVTIiwiUmVjZWl2YWJsZSJdLCJ0YWJsZU5hbWUiOiJJbnZvaWNlcyJ9fX1dfX0=",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "eyIkc2NoZW1hIjoiaHR0cHM6Ly9kZXZlbG9wZXIubWljcm9zb2Z0LmNvbS9qc29uLXNjaGVtYXMvZmFicmljL2dpdEludGVncmF0aW9uL3BsYXRmb3JtUHJvcGVydGllcy8yLjAuMC9zY2hlbWEuanNvbiIsIm1ldGFkYXRhIjp7ImRpc3BsYXlOYW1lIjoibXlNaXJyb3JlZENhdGFsb2ciLCJkZXNjcmlwdGlvbiI6Ik1pcnJvciBzZWxlY3RlZCBzY2hlbWFzIGFuZCB0YWJsZXMifSwiY29uZmlnIjp7InZlcnNpb24iOiIyLjAiLCJsb2dpY2FsSWQiOiIwMDAwMDAwMC0wMDAwLTAwMDAtMDAwMC0wMDAwMDAwMDAwMDAifX0=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

Свойства MirroredCatalogDefinition

Файл MirroredCatalogDefinition.json содержит конфигурацию для элемента зеркального каталога.

Имя Тип Обязательный Description
$schema String истина URL-адрес, определяющий схему, используемую для определения зеркального каталога.
properties Свойства истина Свойства конфигурации зеркального каталога.

Свойства

Имя Тип Обязательный Description
source SourceProperties истина Описывает свойства исходного каталога.
подключенныеtables MountedTable[] false Выводит список таблиц, которые будут зеркально отображаться из исходного каталога. Если таблица не указана, все таблицы под областью зеркально отображаются, а новые таблицы добавляются автоматически.

Свойства источника

Описывает конфигурацию подключения к исходному каталогу и области.

Имя Тип Обязательный Description
тип SourceType истина Тип поставщика исходного каталога. С течением времени могут добавляться дополнительные типы источников.
свойстваТипа SourceTypeProperties истина Свойства исходного подключения, такие как connectionId и scope.

Тип источника

Имя Description
DremioIcebergCatalog Представляет источник каталога Dremio Iceberg.

SourceTypeProperties

Свойства подключения и области для исходного каталога.

Имя Тип Обязательный Description
connectionId Строка (UUID) истина Идентификатор подключения для исходного каталога.
scope String[] истина Путь иерархии пространства имен, охватывающий зеркальное отображение. Должен быть областью выбора. Область выбора — это пространство имен, которое является родительским элементом одного или нескольких конечных пространств имен, содержащих таблицы.

Подключеннаяtable

Определяет таблицу для зеркального отображения из исходного каталога.

Имя Тип Обязательный Description
source MountedTableSourceProperties истина Свойства исходной таблицы.

MountedTableSourceProperties

Исходные свойства для подключенной таблицы.

Имя Тип Обязательный Description
свойстваТипа MountedTableSourceTypeProperties истина Свойства типа исходной таблицы.

MountedTableSourceTypeProperties

Полное имя области и таблицы, определяющие таблицу в исходном каталоге.

Имя Тип Обязательный Description
полностью квалифицированноеScope String[] истина Полная иерархия пространства имен для этой таблицы (например, ["Accounting", "US", "Taxes"]).
tableName String истина Имя таблицы источника.

пример MirroredCatalogDefinition.json

{
  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/mirroredCatalog/definition/mirroredCatalogDefinition/1.0.0/schema.json",
  "properties": {
    "source": {
      "type": "DremioIcebergCatalog",
      "typeProperties": {
        "connectionId": "4eb6b767-e786-45ed-b7cf-d25023e52222",
        "scope": ["Accounting", "US"]
      }
    },
    "mountedTables": [
      {
        "source": {
          "typeProperties": {
            "fullyQualifiedScope": ["Accounting", "US", "Taxes"],
            "tableName": "TaxInfo"
          }
        }
      },
      {
        "source": {
          "typeProperties": {
            "fullyQualifiedScope": ["Accounting", "US", "Receivable"],
            "tableName": "Invoices"
          }
        }
      }
    ]
  }
}
  • Last updated on