미러된 데이터베이스 정의

이 문서에서는 미러된 데이터베이스 항목에 대한 정의 구조의 분석을 제공합니다.

정의 부분

이 표에는 미러된 데이터베이스 정의 부분이 나열되어 있습니다.

정의 파트 경로	유형	필수	설명
`mirroring.json`	MirroredDatabase	✅	미러된 데이터베이스 항목에 대해 설명합니다.
`.platform`	PlatformDetails	❌	항목의 메타데이터를 설명합니다.

미러된 데이터베이스 항목의 정의 부분은 다음과 같이 생성됩니다.

경로: 파일 이름입니다. 예를 들면 다음과 같습니다. mirroring.json
페이로드 유형: InlineBase64
페이로드: Base64에서 디코딩된 페이로드 콘텐츠의 예제 참조

MirroredDatabase

미러된 데이터베이스 항목을 설명합니다.

이름	유형	필수	설명
`source`	SourceProperties	맞다	원본 형식 속성에 대해 설명합니다.
`target`	타겟프로퍼티	맞다	대상 형식 속성에 대해 설명합니다.
`mountedTables`	MountedTable[]	거짓	원본 데이터베이스에서 미러링할 테이블을 나열합니다. 이 속성을 지정하지 않으면 모든 테이블이 미러됩니다. 새 테이블도 복제에 자동으로 추가됩니다.)

SourceProperties

미러링할 원본 데이터베이스에 대해 설명합니다.

이름	유형	필수	설명
`type`	소스 유형	맞다	원본 데이터베이스의 형식입니다.
`typeProperties`	SourceTypeProperties	맞다	원본 연결의 속성(예: `connection`등) `database` 입니다.

소스 유형

원본 형식에 대한 최신 값입니다(시간이 지남에 따라 추가 소스 형식이 추가될 수 있음).

이름	설명
`Snowflake`	눈송이 소스를 나타냅니다.
`AzureSqlDatabase`	Azure SQL Database 원본을 나타냅니다.
`AzureSqlMI`	Azure SQL Managed Instance 원본을 나타냅니다.
`AzurePostgreSql`	Azure PostgreSQL 원본을 나타냅니다.
`CosmosDb`	Cosmos DB 원본을 나타냅니다.
`SqlServer2025`	SQL Server 2025 원본을 나타냅니다.
`MSSQL`	Microsoft SQL Server 2016-2022 원본을 나타냅니다.
`GenericMirror`	열린 미러링 원본을 나타냅니다.

SourceTypeProperties

원본 형식 속성에 대해 설명합니다.

이름	유형	필수	설명
`connection`	가이드	거짓	원본 데이터베이스의 연결 식별자입니다. 원본 형식에는 `GenericMirror` 필요하지 않습니다.
`database`	문자열	거짓	원본 데이터베이스의 이름입니다. , `AzureSqlDatabase`또는 `AzureSqlMIAzurePostgreSql` 원본 형식에는 `GenericMirror`필요하지 않습니다.

타겟프로퍼티

대상 형식 속성에 대해 설명합니다.

이름	유형	필수	설명
`type`	문자열	맞다	대상의 형식입니다(현재 `MountedRelationalDatabase` 는 지원됨).
`typeProperties`	TargetTypeProperties	맞다	대상에 대한 속성(예: `defaultSchema` 및 `format`.

TargetTypeProperties

대상의 속성을 설명합니다.

이름	유형	필수	설명
`defaultSchema`	문자열	거짓	대상의 기본 스키마입니다.
`format`	문자열	맞다	대상의 형식입니다(현재 `Delta` 는 지원됨).

MountedTable

원본 데이터베이스에서 미러링할 테이블을 설명합니다.

이름	유형	필수	설명
`source`	MountedTableSourceProperties	맞다	원본 테이블의 속성(예: `schemaName` 및 `tableName`.

MountedTableSourceProperties

원본 테이블의 속성을 설명합니다.

이름	유형	필수	설명
`typeProperties`	MountedTableSourceTypeProperties	맞다	원본 테이블의 형식 속성입니다.

MountedTableSourceTypeProperties

원본 테이블의 형식 속성에 대해 설명합니다.

이름	유형	필수	설명
`schemaName`	문자열	맞다	원본 테이블의 스키마 이름입니다.
`tableName`	문자열	맞다	원본 테이블의 테이블 이름입니다.

`mirroring.json` 예제

다양한 원본에 대한 미러된 데이터베이스 항목을 설명하는 JSON 파일을 만드는 방법을 보려면 다양한 원본에 대한 미러된 데이터베이스 정의를 참조하세요.

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

정의 예제

다음은 Base64로 인코딩된 미러된 데이터베이스 정의의 예입니다. 여기서 예제의 콘텐츠 mirroring.json 는 Base64로 인코딩되고 경로가 다음과 같이 설정된 mirroring.json필드에 배치 payload 됩니다.

{
  "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 2025-07-09