Compartilhar via


Definição de banco de dados espelhado

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

Partes de definição

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

Caminho da parte de definição Tipo Obrigatório Descrição
mirroring.json MirroredDatabase Descreve o item de banco de dados espelhado
.platform PlatformDetails Descreve os metadados do item

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

MirroredDatabase

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 de tipo de destino.
mountedTables MountedTable[] 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.)

SourceProperties

Descreve o banco de dados de origem a ser espelhado.

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

Tipo de Fonte

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

Nome Descrição
Snowflake Representa uma fonte snowflake.
AzureSqlDatabase Representa uma origem do Banco de Dados SQL do Azure.
AzureSqlMI Representa uma origem da Instância Gerenciada de SQL do Azure.
AzurePostgreSql Representa uma origem do PostgreSQL do Azure.
CosmosDb Representa uma origem do Cosmos DB.
SqlServer2025 Representa uma origem 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 GUID falso O identificador de conexão do banco de dados de origem. Não é necessário para GenericMirror o tipo de origem.
database fio falso O nome do banco de dados de origem. Não é necessário para GenericMirrortipos de origem ou AzurePostgreSql de origemAzureSqlDatabaseAzureSqlMI.

TargetProperties

Descreve as propriedades de tipo de destino.

Nome Tipo Obrigatório Descrição
type fio verdadeiro O tipo do destino (atualmente só MountedRelationalDatabase tem suporte).
typeProperties TargetTypeProperties verdadeiro Propriedades para o destino, como defaultSchema e format.

TargetTypeProperties

Descreve as propriedades do destino.

Nome Tipo Obrigatório Descrição
defaultSchema fio falso O esquema padrão para o destino.
format fio verdadeiro O formato para o destino (atualmente, há suporte apenas Delta ).

MountedTable

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

Nome Tipo Obrigatório Descrição
source MountedTableSourceProperties verdadeiro Propriedades da 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 propriedades para a tabela de origem.

MountedTableSourceTypeProperties

Descreve as propriedades de tipo da tabela de origem.

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

mirroring.json exemplo

Para ver como criar um arquivo JSON que descreve um item de banco de dados espelhado para várias fontes, consulte definições de banco de dados espelhadas 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 espelhada codificada em Base64, em que o conteúdo do mirroring.json exemplo é codificado 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"
      }
    ]
  }
}