Definizione del database con mirroring

Questo articolo fornisce una suddivisione della struttura di definizione per gli elementi del database con mirroring.

Parti di definizione

Questa tabella elenca le parti di definizione del database con mirroring.

Percorso della parte di definizione TIPO Obbligatorio Descrizione
mirroring.json MirroredDatabase Descrive l'elemento del database con mirroring
.platform PlatformDetails Descrive i metadati dell'elemento

La parte di definizione di un elemento del database con mirroring viene costruita nel modo seguente:

MirroredDatabase

Descrive l'elemento del database con mirroring.

Nome TIPO Obbligatorio Descrizione
source SourceProperties vero Descrive le proprietà del tipo di origine.
target proprietà di destinazione vero Descrive le proprietà del tipo di destinazione.
mountedTables MountedTable[] falso Elenca le tabelle di cui eseguire il mirroring dal database di origine. Se questa proprietà non è specificata, verrà eseguito il mirroring di tutte le tabelle. Anche le nuove tabelle verranno aggiunte automaticamente alla replica.

SourceProperties

Descrive il database di origine di cui eseguire il mirroring.

Nome TIPO Obbligatorio Descrizione
type TipoFonte vero Tipo del database di origine.
typeProperties SourceTypeProperties vero Proprietà per la connessione di origine, ad esempio connection, database e così via.

Tipo di Fonte

Valori più recenti per il tipo di origine (è possibile aggiungere altri tipi di origine nel tempo):

Nome Descrizione
AzureMySql Rappresenta un'origine Database di Azure per MySQL.
AzurePostgreSql Rappresenta un'origine Database di Azure per PostgreSQL.
AzureSqlDatabase Rappresenta un'origine del database SQL di Azure.
AzureSqlMI Rappresenta un'origine di Istanza gestita di SQL di Azure.
CosmosDb Rappresenta un'origine Cosmos DB.
GenericMirror Rappresenta un'origine di mirroring aperta.
GoogleBigQuery Rappresenta un'origine Google BigQuery.
MSSQL Rappresenta un'origine di Microsoft SQL Server 2016-2022.
Oracle Rappresenta un'origine Oracle.
SAP Rappresenta un'origine SAP.
SharePointList Rappresenta un'origine elenco SharePoint.
Snowflake Rappresenta un'origine Snowflake.
SqlServer2025 Rappresenta un'origine di SQL Server 2025.

SourceTypeProperties

Descrive le proprietà del tipo di origine.

Nome TIPO Obbligatorio Descrizione
connection Guid falso Identificatore di connessione per il database di origine. Non obbligatorio per GenericMirror i tipi di origine o SAP .
database Stringa falso Nome del database di origine. Obbligatorio solo per Snowflake i tipi di origine e CosmosDb .
externalStorages ExternalStorageProperties[] falso Configurazione di archiviazione esterna per le origini Snowflake, ad esempio Amazon S3.
subType Stringa falso Sottotipo SAP per l'origine. Ad esempio: Datasphere.
landingZone LandingZoneProperties falso Configurazione della zona di destinazione per le origini mirror SAP.

ExternalStorageProperties

Descrive una configurazione di archiviazione esterna per un'origine mirror Snowflake.

Nome TIPO Obbligatorio Descrizione
type Stringa vero Tipo di archiviazione esterno. Ad esempio: AmazonS3.
typeProperties ExternalStorageTypeProperties vero Proprietà per la connessione di archiviazione esterna.

ExternalStorageTypeProperties

Descrive le proprietà di connessione all'archiviazione esterna.

Nome TIPO Obbligatorio Descrizione
connection Guid vero Identificatore di connessione per l'archiviazione esterna.

LandingZoneProperties

Descrive la configurazione della zona di destinazione per un'origine mirror SAP.

Nome TIPO Obbligatorio Descrizione
type Stringa vero Tipo di zona di destinazione. Ad esempio: Lakehouse.
typeProperties LandingZoneTypeProperties vero Proprietà per la connessione alla zona di destinazione.

LandingZoneTypeProperties

Descrive le proprietà di connessione della zona di destinazione.

Nome TIPO Obbligatorio Descrizione
connection Guid vero Identificatore di connessione per la zona di destinazione.
workspaceId Guid vero Identificatore dell'area di lavoro Fabric per la zona di destinazione.
artifactId Guid vero Identificatore dell'elemento Fabric per la zona di destinazione.
rootFolder Stringa vero Percorso della cartella radice all'interno della zona di destinazione.

Proprietà di destinazione

Descrive le proprietà del tipo di destinazione.

Nome TIPO Obbligatorio Descrizione
type Stringa vero Tipo della destinazione (attualmente supportato solo MountedRelationalDatabase ).
typeProperties TargetTypeProperties vero Proprietà per la destinazione, ad esempio defaultSchema e format.

Proprietà del tipo di destinazione

Descrive le proprietà per la destinazione.

Nome TIPO Obbligatorio Descrizione
defaultSchema Stringa falso Schema predefinito per la destinazione.
enableDeltaChangeDataFeed Booleano falso Quando true, abilita delta change data feed (CDF) per il database con mirroring. Questa proprietà viene specificata come target.typeProperties.enableDeltaChangeDataFeed.
format Stringa vero Formato per la destinazione (attualmente è supportato solo Delta ).
retentionInDays Integer falso Numero di giorni in cui conservare i dati con mirroring. I valori supportati sono compresi tra 1 e 30; il valore predefinito è 7.

MountedTable

Descrive una tabella di cui eseguire il mirroring dal database di origine.

Nome TIPO Obbligatorio Descrizione
source MountedTableSourceProperties vero Proprietà per la tabella di origine, ad esempio schemaName e tableName.

MountedTableSourceProperties

Descrive le proprietà per la tabella di origine.

Nome TIPO Obbligatorio Descrizione
typeProperties MountedTableSourceTypeProperties vero Proprietà del tipo per la tabella di origine.

MountedTableSourceTypeProperties

Descrive le proprietà del tipo per la tabella di origine.

Nome TIPO Obbligatorio Descrizione
schemaName Stringa vero Nome dello schema della tabella di origine.
tableName Stringa vero Nome della tabella di origine.

esempio di mirroring.json

Per informazioni su come creare un file JSON che descrive un elemento del database con mirroring per varie origini, vedere Definizioni di database con mirroring per varie origini.

{
    "properties": {
        "source": {
            "type": "Snowflake",
            "typeProperties": {
                "connection": "1d6e9b5e-bdf8-453a-a17e-372c293c7b8a",
                "database": "test",
                "externalStorages": [
                    {
                        "type": "AmazonS3",
                        "typeProperties": {
                            "connection": "71bbebff-149c-4832-920c-7e1aabdabb2a"
                        }
                    }
                ]
            }
        },
        "target": {
            "type": "MountedRelationalDatabase",
            "typeProperties": {
                "defaultSchema": "dbo",
                "format": "Delta",
                "retentionInDays": 1
            }
        },
        "mountedTables": [
            {
                "source": {
                    "typeProperties": {
                        "schemaName": "dbo",
                        "tableName": "testtable"
                    }
                }
            }
        ]
    }
}

L'esempio seguente illustra il modello mirror SAP con subType e landingZone:

{
  "properties": {
    "source": {
      "type": "SAP",
      "typeProperties": {
        "subType": "Datasphere",
        "landingZone": {
          "type": "Lakehouse",
          "typeProperties": {
            "connection": "11111111-2222-3333-4444-555555555555",
            "workspaceId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
            "artifactId": "ffffffff-0000-1111-2222-333333333333",
            "rootFolder": "Files/test"
          }
        }
      }
    },
    "target": {
      "type": "MountedRelationalDatabase",
      "typeProperties": {
        "defaultSchema": "dbo",
        "format": "Delta"
      }
    }
  }
}

Esempio di definizione

Di seguito è riportato un esempio di definizione di database con mirroring con codifica Base64, in cui il contenuto dell'esempiomirroring.json è codificato in Base64 e inserito nel payload campo con il percorso impostato su 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"
      }
    ]
  }
}