ข้อกําหนดของฐานข้อมูลแบบมิเรอร์

บทความนี้มีการแบ่งรายละเอียดของโครงสร้างข้อกําหนดสําหรับรายการฐานข้อมูลแบบมิเรอร์

ส่วนคําจํากัดความ

ตารางนี้แสดงรายการส่วนข้อกําหนดฐานข้อมูลที่มิเรอร์

เส้นทางของส่วนข้อกําหนด ประเภท ต้องระบุ คำอธิบาย
mirroring.json มิเรอร์ดฐานข้อมูล อธิบายรายการฐานข้อมูลที่มิเรอร์
.platform PlatformDetails อธิบายเมตาดาต้าของรายการ

ส่วนข้อกําหนดของรายการฐานข้อมูลแบบมิเรอร์จะถูกสร้างขึ้นดังนี้:

มิเรอร์ดฐานข้อมูล

อธิบายรายการฐานข้อมูลที่มิเรอร์

ชื่อ ประเภท ต้องระบุ คำอธิบาย
source SourceProperties จริง อธิบายคุณสมบัติชนิดแหล่งข้อมูล
target TargetProperties จริง อธิบายคุณสมบัติชนิดเป้าหมาย
mountedTables MountedTable[] เท็จ แสดงรายการตารางที่จะมิเรอร์จากฐานข้อมูลต้นทาง (ถ้าไม่ได้ระบุคุณสมบัตินี้ ตารางทั้งหมดจะมีมิเรอร์ ตารางใหม่จะถูกเพิ่มไปยังการจําลองแบบโดยอัตโนมัติ)

SourceProperties

อธิบายฐานข้อมูลต้นทางที่จะทํามิเรอร์

ชื่อ ประเภท ต้องระบุ คำอธิบาย
type SourceType จริง ชนิดของฐานข้อมูลต้นทาง
typeProperties SourceTypeProperties จริง คุณสมบัติสําหรับการเชื่อมต่อต้นทาง เช่น connection, database และอื่น ๆ

SourceType

ค่าล่าสุดสําหรับชนิดแหล่งข้อมูล (อาจมีการเพิ่มชนิดแหล่งข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป):

ชื่อ คำอธิบาย
AzureMySql แสดงแหล่งข้อมูล Azure Database for MySQL
AzurePostgreSql แสดงแหล่งข้อมูล Azure Database for PostgreSQL
AzureSqlDatabase แสดงแหล่งข้อมูล Azure SQL Database
AzureSqlMI แสดงแหล่งข้อมูลอินสแตนซ์ที่จัดการแล้วของ Azure SQL
CosmosDb แสดงแหล่งข้อมูล Cosmos DB
GenericMirror แสดงแหล่งข้อมูลการมิเรอร์แบบเปิด
GoogleBigQuery แสดงแหล่งข้อมูล Google BigQuery
MSSQL แสดงแหล่งข้อมูล Microsoft SQL Server 2016-2022
Oracle แสดงแหล่งข้อมูล Oracle
SAP แสดงแหล่งข้อมูล SAP
SharePointList แสดงแหล่งข้อมูล รายการ SharePoint
Snowflake แสดงแหล่งข้อมูล Snowflake
SqlServer2025 แสดงแหล่งข้อมูล SQL Server 2025

SourceTypeProperties

อธิบายคุณสมบัติชนิดแหล่งข้อมูล

ชื่อ ประเภท ต้องระบุ คำอธิบาย
connection Guid เท็จ ตัวระบุการเชื่อมต่อสําหรับฐานข้อมูลต้นทาง ไม่จําเป็นต้องมีสําหรับ GenericMirror หรือ SAP ชนิดแหล่งข้อมูล
database สตริง เท็จ ชื่อของฐานข้อมูลต้นทาง จําเป็นสําหรับ Snowflake และ CosmosDb ชนิดแหล่งข้อมูลเท่านั้น
externalStorages ExternalStorageProperties[] เท็จ การกําหนดค่าที่เก็บข้อมูลภายนอกสําหรับแหล่งข้อมูล Snowflake เช่น Amazon S3
subType สตริง เท็จ ชนิดย่อยของ SAP สําหรับแหล่งข้อมูล ตัวอย่างเช่น: Datasphere
landingZone LandingZoneProperties เท็จ การกําหนดค่าโซนเริ่มต้นสําหรับแหล่งมิเรอร์ SAP

ExternalStorageProperties

อธิบายการกําหนดค่าที่เก็บข้อมูลภายนอกสําหรับแหล่งข้อมูล Snowflake mirror

ชื่อ ประเภท ต้องระบุ คำอธิบาย
type สตริง จริง ชนิดที่เก็บข้อมูลภายนอก ตัวอย่างเช่น: AmazonS3
typeProperties ExternalStorageTypeProperties จริง คุณสมบัติสําหรับการเชื่อมต่อที่เก็บข้อมูลภายนอก

ExternalStorageTypeProperties

อธิบายคุณสมบัติการเชื่อมต่อที่เก็บภายนอก

ชื่อ ประเภท ต้องระบุ คำอธิบาย
connection Guid จริง รหัสการเชื่อมต่อสําหรับที่เก็บภายนอก

LandingZoneProperties

อธิบายการกําหนดค่าโซนเริ่มต้นสําหรับแหล่งที่มาของ SAP มิเรอร์

ชื่อ ประเภท ต้องระบุ คำอธิบาย
type สตริง จริง ประเภทโซนเชื่อมโยงไปถึง ตัวอย่างเช่น: Lakehouse
typeProperties LandingZoneTypeProperties จริง คุณสมบัติสําหรับการเชื่อมต่อโซนเริ่มต้น

LandingZoneTypeProperties

อธิบายคุณสมบัติการเชื่อมต่อโซนเริ่มต้น

ชื่อ ประเภท ต้องระบุ คำอธิบาย
connection Guid จริง ตัวระบุการเชื่อมต่อสําหรับโซนเริ่มต้น
workspaceId Guid จริง ตัวระบุพื้นที่ทํางาน Fabric สําหรับโซนเชื่อมโยงไปถึง
artifactId Guid จริง ตัวระบุรายการ Fabric สําหรับโซนเชื่อมโยงไปถึง
rootFolder สตริง จริง เส้นทางโฟลเดอร์รากภายในโซนเริ่มต้น

TargetProperties

อธิบายคุณสมบัติชนิดเป้าหมาย

ชื่อ ประเภท ต้องระบุ คำอธิบาย
type สตริง จริง ชนิดของเป้าหมาย (สนับสนุนเฉพาะในปัจจุบันเท่านั้น MountedRelationalDatabase )
typeProperties TargetTypeProperties จริง คุณสมบัติสําหรับเป้าหมาย เช่น defaultSchema และformat

TargetTypeProperties

อธิบายคุณสมบัติสําหรับเป้าหมาย

ชื่อ ประเภท ต้องระบุ คำอธิบาย
defaultSchema สตริง เท็จ เค้าร่างเริ่มต้นสําหรับเป้าหมาย
enableDeltaChangeDataFeed แบบบูลีน เท็จ เมื่อ trueเปิดใช้งาน Delta เปลี่ยนแปลงตัวดึงข้อมูล (CDF) สําหรับฐานข้อมูลที่มิเรอร์ คุณสมบัตินี้ถูกระบุเป็นtarget.typeProperties.enableDeltaChangeDataFeed
format สตริง จริง รูปแบบสําหรับเป้าหมาย (ปัจจุบันรองรับเท่านั้น Delta )
retentionInDays Integer เท็จ จํานวนวันในการเก็บรักษาข้อมูลแบบมิเรอร์ ค่าที่ได้รับการสนับสนุนมาจาก 1 ถึง 30; ค่าเริ่มต้นคือ 7

เมาท์ตาราง

อธิบายตารางที่จะทํามิเรอร์จากฐานข้อมูลต้นทาง

ชื่อ ประเภท ต้องระบุ คำอธิบาย
source MountedTableSourceProperties จริง คุณสมบัติสําหรับตารางต้นทาง เช่น schemaName และtableName

MountedTableSourceProperties

อธิบายคุณสมบัติสําหรับตารางต้นทาง

ชื่อ ประเภท ต้องระบุ คำอธิบาย
typeProperties MountedTableSourceTypeProperties จริง คุณสมบัติชนิดสําหรับตารางต้นทาง

MountedTableSourceTypeProperties

อธิบายคุณสมบัติชนิดสําหรับตารางต้นทาง

ชื่อ ประเภท ต้องระบุ คำอธิบาย
schemaName สตริง จริง ชื่อเค้าร่างของตารางต้นทาง
tableName สตริง จริง ชื่อตารางของตารางต้นทาง

mirroring.json ตัวอย่าง

เมื่อต้องการดูวิธีการสร้างไฟล์ JSON ที่อธิบายรายการฐานข้อมูลแบบมิเรอร์สําหรับแหล่งข้อมูลต่าง ๆ ให้ดู ข้อกําหนดฐานข้อมูลแบบมิเรอร์สําหรับแหล่งข้อมูลต่าง ๆ

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

ตัวอย่างต่อไปนี้แสดงแบบจําลองมิเรอร์ SAP ที่มี subType และ 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"
      }
    }
  }
}

ตัวอย่างข้อกําหนด

นี่คือตัวอย่างของข้อกําหนดฐานข้อมูลที่เข้ารหัส Base64 ที่เข้ารหัสลับที่เนื้อหาจาก mirroring.json ตัวอย่าง ถูกเข้ารหัสลับใน Base64 และวางใน payload เขตข้อมูลด้วยเส้นทางที่ตั้งค่าเป็น 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"
      }
    ]
  }
}