Definition af spejlvendt database

Denne artikel indeholder en oversigt over definitionsstrukturen for spejlede databaseelementer.

Definitionsdele

I denne tabel vises de spejlede databasedefinitionsdele.

Sti til definitionsdel Type Kræves Beskrivelse
mirroring.json MirroredDatabase Beskriver det spejlede databaseelement
.platform PlatformDetails Beskriver elementets metadata

Definitionsdelen af et spejlvendt databaseelement oprettes på følgende måde:

MirroredDatabase

Beskriver det spejlede databaseelement.

Navn Type Kræves Beskrivelse
source Kildeegenskaber sand Beskriver egenskaberne for kildetypen.
target Målegenskaber sand Beskriver egenskaberne for destinationstypen.
mountedTables MountedTable[] falsk Viser de tabeller, der skal spejles fra kildedatabasen. (Hvis denne egenskab ikke er angivet, afspejles alle tabeller. De nye tabeller føjes også automatisk til replikering.)

Kildeegenskaber

Beskriver den kildedatabase, der skal spejles.

Navn Type Kræves Beskrivelse
type Kildetype sand Kildedatabasens type.
typeProperties SourceTypeProperties sand Egenskaber for kildeforbindelsen, f.eks connection. , database og osv.

Kildetype

Seneste værdier for kildetypen (Yderligere kildetyper kan tilføjes over tid).):

Navn Beskrivelse
AzureMySql Repræsenterer en Azure Database for MySQL kilde.
AzurePostgreSql Repræsenterer en Azure Database for PostgreSQL kilde.
AzureSqlDatabase Repræsenterer en Azure SQL Database-kilde.
AzureSqlMI Repræsenterer en Azure SQL Managed Instance-kilde.
CosmosDb Repræsenterer en Cosmos DB-kilde.
GenericMirror Repræsenterer en åben spejlingskilde.
GoogleBigQuery Repræsenterer en Google BigQuery-kilde.
MSSQL Repræsenterer en Microsoft SQL Server 2016-2022-kilde.
Oracle Repræsenterer en Oracle-kilde.
SAP Repræsenterer en SAP-kilde.
SharePointList Repræsenterer en SharePoint listekilde.
Snowflake Repræsenterer en Snowflake-kilde.
SqlServer2025 Repræsenterer en SQL Server 2025-kilde.

SourceTypeProperties

Beskriver egenskaberne for kildetypen.

Navn Type Kræves Beskrivelse
connection Guid falsk Forbindelses-id'et for kildedatabasen. Ikke påkrævet for GenericMirror eller SAP kildetyper.
database Streng falsk Navnet på kildedatabasen. Kun påkrævet for Snowflake kildetyperne og CosmosDb .
externalStorages ExternalStorageProperties[] falsk Den eksterne lagerkonfiguration for Snowflake-kilder, f.eks. Amazon S3.
subType Streng falsk SAP-undertypen for kilden. F.eks., Datasphere.
landingZone LandingZoneProperties falsk Konfigurationen af landingszonen for SAP-spejlkilder.

ExternalStorageProperties

Beskriver en ekstern lagerkonfiguration for en Snowflake-spejlkilde.

Navn Type Kræves Beskrivelse
type Streng sand Den eksterne lagertype. F.eks., AmazonS3.
typeProperties ExternalStorageTypeProperties sand Egenskaber for den eksterne lagerforbindelse.

ExternalStorageTypeProperties

Beskriver egenskaberne for den eksterne lagerforbindelse.

Navn Type Kræves Beskrivelse
connection Guid sand Forbindelses-id'et for det eksterne lager.

LandingZoneProperties

Beskriver konfigurationen af landingszonen for en SAP-spejlkilde.

Navn Type Kræves Beskrivelse
type Streng sand Landingszonetypen. F.eks., Lakehouse.
typeProperties LandingZoneTypeProperties sand Egenskaber for landingszonens forbindelse.

LandingZoneTypeProperties

Beskriver egenskaberne for forbindelse til landingszonen.

Navn Type Kræves Beskrivelse
connection Guid sand Forbindelses-id'et for landingszonen.
workspaceId Guid sand Det Fabric arbejdsområde-id for landingszonen.
artifactId Guid sand Det Fabric element-id for landingszonen.
rootFolder Streng sand Stien til rodmappen i landingszonen.

Målegenskaber

Beskriver egenskaberne for destinationstypen.

Navn Type Kræves Beskrivelse
type Streng sand Destinationstypen (understøttes i øjeblikket kun MountedRelationalDatabase ).
typeProperties TargetTypeProperties sand Egenskaber for destinationen, f.eks defaultSchema . og format.

TargetTypeProperties

Beskriver egenskaberne for destinationen.

Navn Type Kræves Beskrivelse
defaultSchema Streng falsk Standardskemaet for destinationen.
enableDeltaChangeDataFeed Boolean falsk Når trueaktiverer DELTA Change Data Feed (CDF) for den spejlede database. Denne egenskab er angivet som target.typeProperties.enableDeltaChangeDataFeed.
format Streng sand Formatet for destinationen (understøttes i øjeblikket kun Delta ).
retentionInDays Integer falsk Det antal dage, der skal gemmes spejlede data. Understøttede værdier er fra 1 til og med 30. standardværdien er 7.

MountedTable

Beskriver en tabel, der skal spejles fra kildedatabasen.

Navn Type Kræves Beskrivelse
source MountedTableSourceProperties sand Egenskaber for kildetabellen, f.eks schemaName . og tableName.

MountedTableSourceProperties

Beskriver egenskaberne for kildetabellen.

Navn Type Kræves Beskrivelse
typeProperties MountedTableSourceTypeProperties sand Skriv egenskaber for kildetabellen.

MountedTableSourceTypeProperties

Beskriver typeegenskaberne for kildetabellen.

Navn Type Kræves Beskrivelse
schemaName Streng sand Skemanavnet på kildetabellen.
tableName Streng sand Tabelnavnet på kildetabellen.

mirroring.json eksempel

Hvis du vil se, hvordan du opretter en JSON-fil, der beskriver et spejlet databaseelement for forskellige kilder, skal du se spejlede databasedefinitioner for forskellige kilder.

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

I følgende eksempel vises SAP-spejlmodellen med subType og 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"
      }
    }
  }
}

Eksempel på definition

Her er et eksempel på en Base64-kodet, spejlet databasedefinition, hvor indholdet fra mirroring.json eksemplet kodes i Base64 og placeres i payload feltet, hvor stien er angivet til 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"
      }
    ]
  }
}