Compartir a través de

Definición de base de datos reflejada

En este artículo se proporciona un desglose de la estructura de definición de los elementos de base de datos reflejados.

Elementos de definición

En esta tabla se enumeran las partes de definición de base de datos reflejadas.

Ruta de acceso del elemento de definición Tipo Obligatorio Descripción
mirroring.json MirroredDatabase ✅ Describe el elemento de base de datos reflejado.
.platform PlatformDetails ❌ Describe los metadatos del elemento.

La parte de definición de un elemento de base de datos reflejado se construye de la siguiente manera:

MirroredDatabase

Describe el elemento de base de datos reflejado.

Nombre Tipo Obligatorio Descripción
source SourceProperties cierto Describe las propiedades de tipo de origen.
target TargetProperties cierto Describe las propiedades de tipo de destino.
mountedTables MountedTable[] falso Enumera las tablas que se van a reflejar desde la base de datos de origen. (Si no se especifica esta propiedad, se reflejarán todas las tablas. Las nuevas tablas también se agregarán automáticamente a la replicación).

SourceProperties

Describe la base de datos de origen que se va a reflejar.

Nombre Tipo Obligatorio Descripción
type Tipo de origen cierto Tipo de la base de datos de origen.
typeProperties SourceTypeProperties cierto Propiedades de la conexión de origen, como connection, database y etc.

TipoDeFuente

Valores más recientes para el tipo de origen (se pueden agregar tipos de origen adicionales a lo largo del tiempo):

Nombre Descripción
Snowflake Representa un origen de Snowflake.
AzureSqlDatabase Representa un origen de Azure SQL Database.
AzureSqlMI Representa un origen de Instancia administrada de Azure SQL.
AzurePostgreSql Representa un origen de Azure PostgreSQL.
CosmosDb Representa un origen de Cosmos DB.
SqlServer2025 Representa un origen de SQL Server 2025.
MSSQL Representa un origen de Microsoft SQL Server 2016-2022.
GenericMirror Representa un origen de creación de reflejo abierto.

SourceTypeProperties

Describe las propiedades de tipo de origen.

Nombre Tipo Obligatorio Descripción
connection GUID falso Identificador de conexión de la base de datos de origen. No es necesario para el GenericMirror tipo de origen.
database Cuerda falso Nombre de la base de datos de origen. No es necesario para GenericMirrorlos tipos de origen , AzureSqlDatabase, AzureSqlMIo AzurePostgreSql .

TargetProperties (Propiedades de destino)

Describe las propiedades de tipo de destino.

Nombre Tipo Obligatorio Descripción
type Cuerda cierto Tipo del destino (actualmente solo MountedRelationalDatabase se admite).
typeProperties TargetTypeProperties cierto Propiedades para el destino, como defaultSchema y format.

TargetTypeProperties

Describe las propiedades del destino.

Nombre Tipo Obligatorio Descripción
defaultSchema Cuerda falso Esquema predeterminado para el destino.
format Cuerda cierto El formato del destino (actualmente solo Delta se admite).

MountedTable

Describe una tabla que se va a reflejar desde la base de datos de origen.

Nombre Tipo Obligatorio Descripción
source MountedTableSourceProperties cierto Propiedades de la tabla de origen, como schemaName y tableName.

MountedTableSourceProperties

Describe las propiedades de la tabla de origen.

Nombre Tipo Obligatorio Descripción
typeProperties MountedTableSourceTypeProperties cierto Escriba las propiedades de la tabla de origen.

MountedTableSourceTypeProperties

Describe las propiedades de tipo de la tabla de origen.

Nombre Tipo Obligatorio Descripción
schemaName Cuerda cierto Nombre de esquema de la tabla de origen.
tableName Cuerda cierto Nombre de tabla de la tabla de origen.

mirroring.json ejemplo

Para ver cómo crear un archivo JSON que describa un elemento de base de datos reflejado para varios orígenes, consulte Definiciones de base de datos reflejadas para varios orígenes.

{
    "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"
                    }
                }
            }
        ]
    }
}

Ejemplo de definición

Este es un ejemplo de una definición de base de datos reflejada codificada en Base64, donde el contenido del mirroring.json ejemplo se codifica en Base64 y se coloca en el payload campo con la ruta de acceso establecida mirroring.jsonen :

{
  "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"
      }
    ]
  }
}
  • Last updated on