Items - Create Mirrored Database

Layanan:: MirroredDatabase

Versi API:: v1

Membuat database cermin di ruang kerja yang ditentukan.
API ini tidak mendukung pembuatan database cermin tanpa definisi. Untuk membuat database Cermin dengan definisi, lihat artikel definisi database cermin.

Izin

Pemanggil harus memiliki peran ruang kerja kontributor .

Cakupan yang Didelegasikan yang Diperlukan

MirroredDatabase.ReadWrite.All atau Item.ReadWrite.All

Microsoft Entra identitas yang didukung

API ini mendukung Microsoft identities yang tercantum di bagian ini.

Identitas	Dukung
Pengguna	Ya
Prinsipal Layanan dan Identitas Terkelola	Ya

Antarmuka

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/mirroredDatabases

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
workspaceId	path	True	string (uuid)	ID ruang kerja.

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
definition	True	MirroredDatabaseDefinition	Definisi publik database cermin.
displayName	True	string	Nama tampilan database cermin. Nama tampilan harus mengikuti aturan penamaan sesuai dengan jenis item.
description		string	Deskripsi database yang dicerminkan. Panjang maksimum adalah 256 karakter.
folderId		string (uuid)	ID folder. Jika tidak ditentukan atau null, database cermin dibuat dengan ruang kerja sebagai foldernya.
sensitivityLabelSettings		SensitivityLabelSettings	Pengaturan label sensitivitas untuk database cermin.

Respons

Nama Jenis Deskripsi

201 Created

Nama	Jenis	Deskripsi
201 Created	MirroredDatabase	Berhasil dibuat
429 Too Many Requests	ErrorResponse	Batas tarif layanan terlampaui. Server mengembalikan header yang `Retry-After` menunjukkan, dalam detik, berapa lama klien harus menunggu sebelum mengirim permintaan tambahan. Header Retry-After: integer
Other Status Codes	ErrorResponse	Kode kesalahan umum: InvalidItemType - Tipe item tidak valid ItemDisplayNameAlreadyInUse - Nama tampilan item sudah digunakan. CorruptedPayload - Payload yang disediakan rusak. WorkspaceItemsLimitExceeded - Batas item ruang kerja terlampaui.

MirroredDatabase

Berhasil dibuat

429 Too Many Requests

ErrorResponse

Batas tarif layanan terlampaui. Server mengembalikan header yang Retry-After menunjukkan, dalam detik, berapa lama klien harus menunggu sebelum mengirim permintaan tambahan.

Header

Retry-After: integer

Other Status Codes

ErrorResponse

Kode kesalahan umum:

InvalidItemType - Tipe item tidak valid
ItemDisplayNameAlreadyInUse - Nama tampilan item sudah digunakan.
CorruptedPayload - Payload yang disediakan rusak.
WorkspaceItemsLimitExceeded - Batas item ruang kerja terlampaui.

Contoh

Create a mirrored database with public definition example

Permintaan sampel

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/mirroredDatabases

{
  "displayName": "Mirrored database 1",
  "description": "A mirrored database description",
  "definition": {
    "parts": [
      {
        "path": "mirroring.json",
        "payload": "eyAicHJvcGVydGllcy..WJsZSIgfSB9IH0gXSB9IH0",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

Respon sampel

Kode status:: 201

{
  "displayName": "Mirrored database 1",
  "description": "A mirrored database description",
  "type": "MirroredDatabase",
  "workspaceId": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
  "id": "b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}

Definisi

Nama	Deskripsi
CreateMirroredDatabaseRequest	Buat payload permintaan database cermin.
EntireTenantPrincipal	Mewakili perwakilan penyewa
ErrorRelatedResource	Objek detail sumber daya terkait kesalahan.
ErrorResponse	Respons kesalahan.
ErrorResponseDetails	Detail respons kesalahan.
GroupDetails	Mengelompokkan detail spesifik. Berlaku ketika jenis utama `Group`.
GroupPrincipal	Mewakili grup keamanan.
GroupType	Jenis grup. Jenis grup tambahan dapat ditambahkan dari waktu ke waktu.
ItemTag	Mewakili tag yang diterapkan pada item.
ItemType	Jenis item. Jenis item tambahan dapat ditambahkan dari waktu ke waktu.
MirroredDatabase	Item database cermin.
MirroredDatabaseDefinition	Objek definisi publik database cermin. Lihat artikel ini untuk detail selengkapnya tentang struktur definisi database Cermin.
MirroredDatabaseDefinitionPart	Objek bagian definisi database cermin.
MirroredDatabaseProperties	Properti database cermin.
PayloadType	Jenis payload bagian definisi. Jenis payload tambahan dapat ditambahkan dari waktu ke waktu.
PrincipalType	Jenis prinsipal. Jenis utama tambahan dapat ditambahkan dari waktu ke waktu.
SensitivityLabel	Mewakili label sensitivitas yang diterapkan ke item.
SensitivityLabelApplyStrategy	Strategi untuk menerapkan label sensitivitas. Nilai defaultnya adalah ApplyOrFail. Jenis tambahan dapat ditambahkan dari waktu ke waktu.
SensitivityLabelSettings	Pengaturan label sensitivitas.
ServicePrincipalDetails	Detail spesifik perwakilan layanan. Berlaku ketika jenis utama `ServicePrincipal`.
ServicePrincipalPrincipal	Mewakili perwakilan layanan Microsoft Entra.
ServicePrincipalProfileDetails	Detail profil perwakilan layanan. Berlaku ketika jenis utama `ServicePrincipalProfile`.
ServicePrincipalProfilePrincipal	Mewakili profil perwakilan layanan.
SqlEndpointProperties	Objek yang berisi properti titik akhir SQL.
SqlEndpointProvisioningStatus	Jenis status provisi titik akhir SQL. Jenis `SqlEndpointProvisioningStatus` tambahan dapat ditambahkan dari waktu ke waktu.
UserDetails	Detail spesifik perwakilan pengguna. Berlaku ketika jenis utama `User`.
UserPrincipal	Mewakili prinsipal pengguna Microsoft Entra.

CreateMirroredDatabaseRequest

Objek

Buat payload permintaan database cermin.

Nama	Jenis	Deskripsi
definition	MirroredDatabaseDefinition	Definisi publik database cermin.
description	string	Deskripsi database yang dicerminkan. Panjang maksimum adalah 256 karakter.
displayName	string	Nama tampilan database cermin. Nama tampilan harus mengikuti aturan penamaan sesuai dengan jenis item.
folderId	string (uuid)	ID folder. Jika tidak ditentukan atau null, database cermin dibuat dengan ruang kerja sebagai foldernya.
sensitivityLabelSettings	SensitivityLabelSettings	Pengaturan label sensitivitas untuk database cermin.

EntireTenantPrincipal

Objek

Mewakili perwakilan penyewa

Nama	Jenis	Deskripsi
displayName	string	Nama tampilan utama.
id	string (uuid)	Id utama.
type	string: EntireTenant	Jenis prinsipal. Jenis utama tambahan dapat ditambahkan dari waktu ke waktu.

ErrorRelatedResource

Objek

Objek detail sumber daya terkait kesalahan.

Nama	Jenis	Deskripsi
resourceId	string	ID sumber daya yang terlibat dalam kesalahan.
resourceType	string	Jenis sumber daya yang terlibat dalam kesalahan.

ErrorResponse

Objek

Respons kesalahan.

Nama	Jenis	Deskripsi
errorCode	string	Pengidentifikasi tertentu yang menyediakan informasi tentang kondisi kesalahan, memungkinkan komunikasi standar antara layanan kami dan penggunanya.
isRetriable	boolean	Jika benar, permintaan dapat dicoba kembali. `Retry-After` Gunakan header respons untuk menentukan penundaan, jika tersedia.
message	string	Representasi kesalahan yang dapat dibaca manusia.
moreDetails	ErrorResponseDetails[]	Daftar detail kesalahan tambahan.
relatedResource	ErrorRelatedResource	Detail sumber daya terkait kesalahan.
requestId	string (uuid)	ID permintaan yang terkait dengan kesalahan.

ErrorResponseDetails

Objek

Detail respons kesalahan.

Nama	Jenis	Deskripsi
errorCode	string	Pengidentifikasi tertentu yang menyediakan informasi tentang kondisi kesalahan, memungkinkan komunikasi standar antara layanan kami dan penggunanya.
message	string	Representasi kesalahan yang dapat dibaca manusia.
relatedResource	ErrorRelatedResource	Detail sumber daya terkait kesalahan.

GroupDetails

Objek

Mengelompokkan detail spesifik. Berlaku ketika jenis utama Group.

Nama	Jenis	Deskripsi
groupType	GroupType	Jenis grup. Jenis grup tambahan dapat ditambahkan dari waktu ke waktu.

GroupPrincipal

Objek

Mewakili grup keamanan.

Nama	Jenis	Deskripsi
displayName	string	Nama tampilan utama.
groupDetails	GroupDetails	Mengelompokkan detail spesifik. Berlaku ketika jenis utama `Group`.
id	string (uuid)	Id utama.
type	string: Group	Jenis prinsipal. Jenis utama tambahan dapat ditambahkan dari waktu ke waktu.

GroupType

Enumerasi

Jenis grup. Jenis grup tambahan dapat ditambahkan dari waktu ke waktu.

Nilai	Deskripsi
Unknown	Jenis grup utama tidak diketahui.
SecurityGroup	Prinsipal adalah kelompok keamanan.
DistributionList	Prinsipal adalah daftar distribusi.

ItemTag

Objek

Mewakili tag yang diterapkan pada item.

Nama	Jenis	Deskripsi
displayName	string	Nama dari tag.
id	string (uuid)	ID tag.

ItemType

Enumerasi

Jenis item. Jenis item tambahan dapat ditambahkan dari waktu ke waktu.

Nilai	Deskripsi
Dashboard	Dasbor PowerBI.
Report	Laporan PowerBI.
SemanticModel	Model semantik PowerBI.
PaginatedReport	Laporan paginasi PowerBI.
Datamart	Datamart PowerBI.
Lakehouse	Sebuah lakehouse.
Eventhouse	Sebuah rumah acara.
Environment	Lingkungan.
KQLDatabase	Database KQL.
KQLQueryset	Set kueri KQL.
KQLDashboard	Dasbor KQL.
DataPipeline	Alur data.
Notebook	Buku catatan.
SparkJobDefinition	Definisi pekerjaan spark.
MLExperiment	Eksperimen pembelajaran mesin.
MLModel	Model pembelajaran mesin.
Warehouse	Sebuah gudang.
Eventstream	Eventstream.
SQLEndpoint	Titik akhir SQL.
MirroredWarehouse	Sebuah gudang cermin.
MirroredDatabase	Database cermin.
Reflex	Sebuah Refleks.
GraphQLApi	API untuk item GraphQL.
MountedDataFactory	A MountedDataFactory.
SQLDatabase	Sebuah SQLDatabase.
CopyJob	Pekerjaan Penyalinan.
VariableLibrary	VariabelLibrary.
Dataflow	Aliran Data.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	Rekam jepret gudang.
DigitalTwinBuilder	Sebuah DigitalTwinBuilder.
DigitalTwinBuilderFlow	Alur Pembangun Kembar Digital.
MirroredAzureDatabricksCatalog	Katalog azure databricks cermin.
Map	Peta.
AnomalyDetector	Detektor Anomali.
UserDataFunction	Fungsi data pengguna.
GraphModel	Sebuah GraphModel.
GraphQuerySet	A Graph QuerySet.
SnowflakeDatabase	Snowflake Database untuk menyimpan tabel Iceberg yang dibuat dari akun Snowflake.
OperationsAgent	A OperationsAgent.
CosmosDBDatabase	Database Cosmos DB.
Ontology	Ontologi.
EventSchemaSet	An EventSchemaSet.
DataAgent	A DataAgent.
MirroredCatalog	A MirroredCatalog.
AppBackend	An AppBackend.
OrgApp	Aplikasi Org.
OrgAppAudience	Audiens Aplikasi Org.
DataBuildToolJob	A DataBuildToolJob.
AzureDatabricksStorage	Item penyimpanan yang didukung OneLake untuk Azure Databricks.
Plan	Sebuah rencana.

MirroredDatabase

Objek

Item database cermin.

Nama	Jenis	Deskripsi
defaultIdentity	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Identitas default item.
description	string	Deskripsi item.
displayName	string	Nama tampilan item.
folderId	string (uuid)	ID folder.
id	string (uuid)	ID item.
properties	MirroredDatabaseProperties	Properti database cermin.
sensitivityLabel	SensitivityLabel	Label sensitivitas item.
tags	ItemTag[]	Daftar tag yang diterapkan.
type	ItemType	Jenis item.
workspaceId	string (uuid)	ID ruang kerja.

MirroredDatabaseDefinition

Objek

Objek definisi publik database cermin. Lihat artikel ini untuk detail selengkapnya tentang struktur definisi database Cermin.

Nama	Jenis	Deskripsi
format	string	Format definisi database yang dicerminkan.
parts	MirroredDatabaseDefinitionPart[]	Daftar bagian definisi.

MirroredDatabaseDefinitionPart

Objek

Objek bagian definisi database cermin.

Nama	Jenis	Deskripsi
path	string	Jalur bagian database yang dicerminkan.
payload	string	Payload bagian database yang dicerminkan.
payloadType	PayloadType	Jenis payload.

MirroredDatabaseProperties

Objek

Properti database cermin.

Nama	Jenis	Deskripsi
defaultSchema	string	Skema default database cermin. Properti ini dikembalikan hanya untuk database cermin yang mengaktifkan skema default dalam definisi.
oneLakeTablesPath	string	Jalur OneLake ke direktori tabel database cermin.
sqlEndpointProperties	SqlEndpointProperties	Objek yang berisi properti titik akhir SQL.

PayloadType

Enumerasi

Jenis payload bagian definisi. Jenis payload tambahan dapat ditambahkan dari waktu ke waktu.

Nilai	Deskripsi
InlineBase64	Dasar Sebaris 64.

PrincipalType

Enumerasi

Jenis prinsipal. Jenis utama tambahan dapat ditambahkan dari waktu ke waktu.

Nilai	Deskripsi
User	Prinsipal adalah prinsipal pengguna Microsoft Entra.
ServicePrincipal	Perwakilan adalah perwakilan layanan Microsoft Entra.
Group	Prinsipal adalah kelompok keamanan.
ServicePrincipalProfile	Perwakilan adalah profil perwakilan layanan.
EntireTenant	Perwakilan mewakili semua pengguna penyewa.

SensitivityLabel

Objek

Mewakili label sensitivitas yang diterapkan ke item.

Nama	Jenis	Deskripsi
id	string (uuid)	ID label sensitivitas.

SensitivityLabelApplyStrategy

Enumerasi

Strategi untuk menerapkan label sensitivitas. Nilai defaultnya adalah ApplyOrFail. Jenis tambahan dapat ditambahkan dari waktu ke waktu.

Nilai	Deskripsi
ApplyOrFail	Terapkan label sensitivitas atau gagal operasi jika tidak dapat diterapkan.
Ignore	Abaikan label sensitivitas jika tidak dapat diterapkan dan lanjutkan dengan operasi tanpa menerapkan label.

SensitivityLabelSettings

Objek

Pengaturan label sensitivitas.

Nama	Jenis	Deskripsi
labelId	string (uuid)	ID label sensitivitas.
sensitivityLabelApplyStrategy	SensitivityLabelApplyStrategy	Strategi untuk menerapkan label sensitivitas.

ServicePrincipalDetails

Objek

Detail spesifik perwakilan layanan. Berlaku ketika jenis utama ServicePrincipal.

Nama	Jenis	Deskripsi
aadAppId	string (uuid)	AppId Microsoft Entra perwakilan layanan.

ServicePrincipalPrincipal

Objek

Mewakili perwakilan layanan Microsoft Entra.

Nama	Jenis	Deskripsi
displayName	string	Nama tampilan utama.
id	string (uuid)	Id utama.
servicePrincipalDetails	ServicePrincipalDetails	Detail spesifik perwakilan layanan. Berlaku ketika jenis utama `ServicePrincipal`.
type	string: ServicePrincipal	Jenis prinsipal. Jenis utama tambahan dapat ditambahkan dari waktu ke waktu.

ServicePrincipalProfileDetails

Objek

Detail profil perwakilan layanan. Berlaku ketika jenis utama ServicePrincipalProfile.

Nama	Jenis	Deskripsi
parentPrincipal	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Perwakilan induk profil perwakilan layanan.

ServicePrincipalProfilePrincipal

Objek

Mewakili profil perwakilan layanan.

Nama	Jenis	Deskripsi
displayName	string	Nama tampilan utama.
id	string (uuid)	Id utama.
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	Detail profil perwakilan layanan. Berlaku ketika jenis utama `ServicePrincipalProfile`.
type	string: ServicePrincipalProfile	Jenis prinsipal. Jenis utama tambahan dapat ditambahkan dari waktu ke waktu.

SqlEndpointProperties

Objek

Objek yang berisi properti titik akhir SQL.

Nama	Jenis	Deskripsi
connectionString	string	titik akhir SQL string koneksi.
id	string	ID titik akhir SQL.
provisioningStatus	SqlEndpointProvisioningStatus	Status provisi titik akhir SQL.

SqlEndpointProvisioningStatus

Enumerasi

Jenis status provisi titik akhir SQL. Jenis SqlEndpointProvisioningStatus tambahan dapat ditambahkan dari waktu ke waktu.

Nilai	Deskripsi
InProgress	Provisi titik akhir SQL sedang berlangsung.
Success	Provisi titik akhir SQL berhasil.
Failed	Penyediaan titik akhir SQL gagal.

UserDetails

Objek

Detail spesifik perwakilan pengguna. Berlaku ketika jenis utama User.

Nama	Jenis	Deskripsi
userPrincipalName	string	Nama prinsipal pengguna.

UserPrincipal

Objek

Mewakili prinsipal pengguna Microsoft Entra.

Nama	Jenis	Deskripsi
displayName	string	Nama tampilan utama.
id	string (uuid)	Id utama.
type	string: User	Jenis prinsipal. Jenis utama tambahan dapat ditambahkan dari waktu ke waktu.
userDetails	UserDetails	Detail spesifik perwakilan pengguna. Berlaku ketika jenis utama `User`.