Definição de banco de dados espelhado

Este artigo fornece um detalhamento da estrutura de definição para itens de banco de dados espelhados.

Peças de definição

Esta tabela lista as partes de definição de banco de dados espelhadas.

Caminho da parte de definição	Tipo	Obrigatório	Descrição
mirroring.json	Banco de dados espelhado	✅	Descreve o item de banco de dados espelhado
.platform	Detalhes da plataforma	❌	Descreve os metadados do item

Parte de definição de um item de banco de dados espelhado é construída da seguinte maneira:

• Caminho: O nome do arquivo, por exemplo: mirroring.json
• Tipo de carga útil: InlineBase64
• Carga útil: Consulte Exemplo de conteúdo de carga útil decodificado da Base64

Base de dados espelhada

Descreve o item de banco de dados espelhado.

Nome	Tipo	Obrigatório	Descrição
source	SourceProperties	verdadeiro	Descreve as propriedades do tipo de origem.
target	TargetProperties	verdadeiro	Descreve as propriedades do tipo de destino.
mountedTables	Tabela Montada[]	falso	Lista as tabelas a serem espelhadas do banco de dados de origem. (Se essa propriedade não for especificada, todas as tabelas serão espelhadas. As novas tabelas também serão adicionadas automaticamente à replicação.)

Propriedades da Fonte

Descreve o banco de dados de origem a ser espelhado.

Nome	Tipo	Obrigatório	Descrição
type	Tipo de fonte	verdadeiro	O tipo do banco de dados de origem.
typeProperties	SourceTypeProperties	verdadeiro	Propriedades para a conexão de origem, como connection, database e etc.

Tipo de fonte

Valores mais recentes para o tipo de fonte (Tipos de fonte adicionais podem ser adicionados ao longo do tempo.):

Nome	Descrição
Snowflake	Representa uma fonte de floco de neve.
AzureSqlDatabase	Representa uma fonte do Banco de Dados SQL do Azure.
AzureSqlMI	Representa uma origem de Instância Gerenciada SQL do Azure.
AzurePostgreSql	Representa uma fonte do Azure PostgreSQL.
CosmosDb	Representa uma fonte do Cosmos DB.
SqlServer2025	Representa uma fonte do SQL Server 2025.
MSSQL	Representa uma fonte do Microsoft SQL Server 2016-2022.
GenericMirror	Representa uma fonte de espelhamento aberta.

SourceTypeProperties

Descreve as propriedades do tipo de origem.

Nome	Tipo	Obrigatório	Descrição
connection	Guia	falso	O identificador de conexão para o banco de dados de origem. Não é necessário para GenericMirror o tipo de origem.
database	Cordão	falso	O nome do banco de dados de origem. Não é necessário para GenericMirror, AzureSqlDatabase, AzureSqlMI, ou AzurePostgreSql tipos de origem.

TargetProperties

Descreve as propriedades do tipo de destino.

Nome	Tipo	Obrigatório	Descrição
type	Cordão	verdadeiro	O tipo de destino (atualmente apenas MountedRelationalDatabase é suportado).
typeProperties	TargetTypeProperties	verdadeiro	Propriedades para o destino, como defaultSchema e format.

TargetTypeProperties

Descreve as propriedades para o destino.

Nome	Tipo	Obrigatório	Descrição
defaultSchema	Cordão	falso	O esquema padrão para o destino.
format	Cordão	verdadeiro	O formato para o destino (atualmente apenas Delta é suportado).

Tabela Montada

Descreve uma tabela a ser espelhada do banco de dados de origem.

Nome	Tipo	Obrigatório	Descrição
source	MountedTableSourceProperties	verdadeiro	Propriedades para a tabela de origem, como schemaName e tableName.

MountedTableSourceProperties

Descreve as propriedades da tabela de origem.

Nome	Tipo	Obrigatório	Descrição
typeProperties	MountedTableSourceTypeProperties	verdadeiro	Digite as propriedades da tabela de origem.

MountedTableSourceTypeProperties

Descreve as propriedades de tipo para a tabela de origem.

Nome	Tipo	Obrigatório	Descrição
schemaName	Cordão	verdadeiro	O nome do esquema da tabela de origem.
tableName	Cordão	verdadeiro	O nome da tabela de origem.

mirroring.json exemplo

Para ver como criar um arquivo JSON descrevendo um item de banco de dados espelhado para várias fontes, consulte Definições de banco de dados espelhado para várias fontes.

{
    "properties": {
        "source": {
            "type": "Snowflake",
            "typeProperties": {
                "connection": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
                "database": "TESTDB"
            }
        },
        "target": {
            "type": "MountedRelationalDatabase",
            "typeProperties": {
                "defaultSchema": "dbo",
                "format": "Delta"
            }
        },
        "mountedTables": [
            {
                "source": {
                    "typeProperties": {
                        "schemaName": "dbo",
                        "tableName": "testtable"
                    }
                }
            }
        ]
    }
}

Exemplo de definição

Aqui está um exemplo de uma definição de banco de dados espelhado codificado em Base64, onde o conteúdo do exemplo é codificado mirroring.json em Base64 e colocado no payload campo com o caminho definido como mirroring.json:

{
  "displayName": "myMirroredDatabase",
  "type": "MirroredDatabase",
  "description": "Create Mirrored Database item with definition",
  "definition": {
    "parts": [
      {
        "path": "mirroring.json",
        "payload": "<base64 encoded string>",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "<base64 encoded string>",
        "payloadType": "InlineBase64"
      }
    ]
  }
}