ミラー化されたデータベース定義

この記事では、ミラー化されたデータベース項目の定義構造の詳細について説明します。

定義パーツ

次の表に、ミラー化されたデータベース定義パーツの一覧を示します。

定義パーツのパス	タイプ	必須	説明
`mirroring.json`	MirroredDatabase	✅	ミラー化されたデータベース項目について説明します
`.platform`	PlatformDetails	❌	アイテムのメタデータについて説明します

ミラー化されたデータベース項目の定義部分は、次のように構成されます。

パス: 次に例を示すファイル名を指定します。 mirroring.json
ペイロードの種類: InlineBase64
ペイロード: Base64 からデコードされたペイロードコンテンツの例を参照してください

MirroredDatabase

ミラー化されたデータベース項目について説明します。

名前	タイプ	必須	説明
`source`	SourceProperties	ほんとう	ソース型のプロパティについて説明します。
`target`	ターゲットプロパティ	ほんとう	ターゲット型のプロパティについて説明します。
`mountedTables`	MountedTable[]	偽り	ソースデータベースからミラー化するテーブルを一覧表示します。 (このプロパティが指定されていない場合、すべてのテーブルがミラー化されます。新しいテーブルもレプリケーションに自動的に追加されます)。

ソースプロパティーズ

ミラー化するソースデータベースについて説明します。

名前	タイプ	必須	説明
`type`	[SourceType]	ほんとう	ソースデータベースの型。
`typeProperties`	SourceTypeProperties	ほんとう	ソース接続のプロパティ ( `connection`、 `database` など)。

ソースタイプ

ソースの種類の最新の値 (追加のソースの種類は、時間の経過と同時に追加される場合があります)。

名前	説明
`Snowflake`	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`	Guid	偽り	ソースデータベースの接続識別子。ソースの種類 `GenericMirror` 必要ありません。
`database`	糸	偽り	ソースデータベースの名前。 `GenericMirror`、`AzureSqlDatabase`、`AzureSqlMI`、または`AzurePostgreSql`ソースの種類には必要ありません。

ターゲットプロパティ

ターゲット型のプロパティについて説明します。

名前	タイプ	必須	説明
`type`	糸	ほんとう	ターゲットの型 (現在、 `MountedRelationalDatabase` のみがサポートされています)。
`typeProperties`	TargetTypeProperties	ほんとう	ターゲットのプロパティ ( `defaultSchema` 、 `format`など)。

TargetTypeプロパティ

ターゲットのプロパティについて説明します。

名前	タイプ	必須	説明
`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