Items - Create Mirrored Database

บริการ:

MirroredDatabase

เวอร์ชัน API:

v1

สร้างฐานข้อมูลแบบมิเรอร์ในพื้นที่ทํางานที่ระบุ
API นี้ไม่สนับสนุนการสร้างฐานข้อมูลแบบมิเรอร์โดยไม่มีข้อกําหนด เมื่อต้องการสร้างฐานข้อมูลแบบมิเรอร์ด้วยข้อกําหนด ให้อ้างอิงถึงบทความ ข้อกําหนดของฐานข้อมูลแบบมิเรอร์

สิทธิ์

ผู้เรียกต้องมีบทบาทพื้นที่ทํางานผู้สนับสนุน

จําเป็นต้องมีขอบเขตที่ได้รับมอบสิทธิ์

MirroredDatabase.ReadWrite.All หรือ Item.ReadWrite.All

ข้อมูลประจําตัวที่สนับสนุนของ Microsoft Entra

API นี้สนับสนุนข้อมูลประจําตัวของ Microsoft แสดงรายการในส่วนนี้

เอกลักษณ์	สนับสนุน
ผู้ใช้	ใช่
บริการหลักและข้อมูลประจําตัว ที่มีการจัดการ	ใช่

อิน เทอร์ เฟซ

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

พารามิเตอร์ URI

ชื่อ	ใน	จำเป็น	พิมพ์	คำอธิบาย
workspaceId	path	True	string (uuid)	ID พื้นที่ทํางาน

เนื้อความของคำขอ

ชื่อ	จำเป็น	พิมพ์	คำอธิบาย
definition	True	MirroredDatabaseDefinition	ข้อกําหนดสาธารณะของฐานข้อมูลที่มิเรอร์
displayName	True	string	ชื่อที่แสดงของฐานข้อมูลที่มิเรอร์ ชื่อที่แสดงต้องเป็นไปตามกฎการตั้งชื่อตามชนิดหน่วยข้อมูล
description		string	คําอธิบายฐานข้อมูลที่มิเรอร์ ความยาวสูงสุดคือ 256 อักขระ
folderId		string (uuid)	ID โฟลเดอร์ ถ้าไม่ได้ระบุ หรือ null ฐานข้อมูลที่มิเรอร์จะถูกสร้างขึ้นด้วยพื้นที่ทํางานเป็นโฟลเดอร์

การตอบสนอง

ชื่อ	พิมพ์	คำอธิบาย
201 Created	MirroredDatabase	สร้างเสร็จเรียบร้อยแล้ว
Other Status Codes	ErrorResponse	รหัสข้อผิดพลาดทั่วไป: InvalidItemType - ชนิดรายการไม่ถูกต้อง ItemDisplayNameAlreadyInUse - ชื่อที่ใช้แสดงรายการถูกใช้แล้ว CorruptedPayload - ส่วนข้อมูลที่ให้มาเสียหาย WorkspaceItemsLimitExceeded - เกินขีดจํากัดของรายการพื้นที่ทํางาน

ตัวอย่าง

Create a mirrored database with public definition example

คำขอตัวอย่าง

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

คำตอบตัวอย่าง

รหัสสถานะ:

201

{
  "displayName": "Mirrored database 1",
  "description": "A mirrored database description",
  "type": "MirroredDatabase",
  "workspaceId": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
  "id": "b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2"
}

คำจำกัดความ

ชื่อ	คำอธิบาย
CreateMirroredDatabaseRequest	สร้างส่วนข้อมูลการร้องขอฐานข้อมูลแบบมิเรอร์
ErrorRelatedResource	ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
ErrorResponse	การตอบสนองข้อผิดพลาด
ErrorResponseDetails	รายละเอียดการตอบสนองข้อผิดพลาด
ItemTag	แสดงแท็กที่ใช้กับรายการ
ItemType	ชนิดของสินค้า คุณสามารถเพิ่มชนิดหน่วยข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป
MirroredDatabase	รายการฐานข้อมูลแบบมิเรอร์
MirroredDatabaseDefinition	วัตถุข้อกําหนดสาธารณะของฐานข้อมูลแบบมิเรอร์
MirroredDatabaseDefinitionPart	ออบเจ็กต์ส่วนของข้อกําหนดฐานข้อมูลที่มิเรอร์
MirroredDatabaseProperties	คุณสมบัติฐานข้อมูลแบบมิเรอร์
PayloadType	ชนิดของส่วนข้อกําหนดส่วนข้อมูล อาจมีการเพิ่มชนิดของส่วนข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป
SqlEndpointProperties	ออบเจ็กต์ที่ประกอบด้วยคุณสมบัติของจุดสิ้นสุด SQL
SqlEndpointProvisioningStatus	ชนิดสถานะการเตรียมใช้งานจุดสิ้นสุด SQL ประเภท SqlEndpointProvisioningStatus เพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป

CreateMirroredDatabaseRequest

วัตถุ

สร้างส่วนข้อมูลการร้องขอฐานข้อมูลแบบมิเรอร์

ชื่อ	พิมพ์	คำอธิบาย
definition	MirroredDatabaseDefinition	ข้อกําหนดสาธารณะของฐานข้อมูลที่มิเรอร์
description	string	คําอธิบายฐานข้อมูลที่มิเรอร์ ความยาวสูงสุดคือ 256 อักขระ
displayName	string	ชื่อที่แสดงของฐานข้อมูลที่มิเรอร์ ชื่อที่แสดงต้องเป็นไปตามกฎการตั้งชื่อตามชนิดหน่วยข้อมูล
folderId	string (uuid)	ID โฟลเดอร์ ถ้าไม่ได้ระบุ หรือ null ฐานข้อมูลที่มิเรอร์จะถูกสร้างขึ้นด้วยพื้นที่ทํางานเป็นโฟลเดอร์

ErrorRelatedResource

วัตถุ

ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ชื่อ	พิมพ์	คำอธิบาย
resourceId	string	ID ทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
resourceType	string	ชนิดของทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponse

วัตถุ

การตอบสนองข้อผิดพลาด

ชื่อ	พิมพ์	คำอธิบาย
errorCode	string	ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
message	string	การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
moreDetails	ErrorResponseDetails[]	รายการรายละเอียดข้อผิดพลาดเพิ่มเติม
relatedResource	ErrorRelatedResource	รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
requestId	string	รหัสของคําขอที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponseDetails

วัตถุ

รายละเอียดการตอบสนองข้อผิดพลาด

ชื่อ	พิมพ์	คำอธิบาย
errorCode	string	ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
message	string	การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
relatedResource	ErrorRelatedResource	รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ItemTag

วัตถุ

แสดงแท็กที่ใช้กับรายการ

ชื่อ	พิมพ์	คำอธิบาย
displayName	string	ชื่อของแท็ก
id	string (uuid)	ID แท็ก

ItemType

การแจงนับ

ชนิดของสินค้า คุณสามารถเพิ่มชนิดหน่วยข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
Dashboard	แดชบอร์ด PowerBI
Report	รายงาน PowerBI
SemanticModel	แบบจําลองความหมายของ PowerBI
PaginatedReport	รายงานที่มีการแบ่งหน้าของ PowerBI
Datamart	Datamart ของ PowerBI
Lakehouse	เลคเฮ้าส์
Eventhouse	อาคารจัดงาน
Environment	สภาพแวดล้อม
KQLDatabase	ฐานข้อมูล KQL
KQLQueryset	ชุดคิวรี KQL
KQLDashboard	แดชบอร์ด KQL
DataPipeline	ไปป์ไลน์ข้อมูล
Notebook	โน๊ตบุ๊ค
SparkJobDefinition	ข้อกําหนดงานแบบประกายไฟ
MLExperiment	การทดลองการเรียนรู้ของเครื่อง
MLModel	แบบจําลองการเรียนรู้ของเครื่อง
Warehouse	คลังสินค้า
Eventstream	เหตุการณ์กระแสข้อมูล
SQLEndpoint	จุดสิ้นสุด SQL
MirroredWarehouse	คลังสินค้าที่มิเรอร์
MirroredDatabase	ฐานข้อมูลที่มิเรอร์
Reflex	รีเฟล็กซ์
GraphQLApi	API สําหรับรายการ GraphQL
MountedDataFactory	เมาท์ DataFactory
SQLDatabase	SQLDatabase
CopyJob	งานคัดลอก
VariableLibrary	VariableLibrary
Dataflow	กระแสข้อมูล
ApacheAirflowJob	ApacheAirflowJob
WarehouseSnapshot	สแนปช็อตของคลังสินค้า
DigitalTwinBuilder	DigitalTwinBuilder
DigitalTwinBuilderFlow	โฟลว์ Digital Twin Builder
MirroredAzureDatabricksCatalog	แค็ตตาล็อก azure databricks ที่มิเรอร์
Map	แผนที่.
AnomalyDetector	การตรวจหาความผิดปกติ
UserDataFunction	ฟังก์ชันข้อมูลผู้ใช้
GraphModel	GraphModel
GraphQuerySet	ชุดคิวรีกราฟ
SnowflakeDatabase	ฐานข้อมูล Snowflake เพื่อจัดเก็บตาราง Iceberg ที่สร้างขึ้นจากบัญชี Snowflake
OperationsAgent	OperationsAgent
CosmosDBDatabase	ฐานข้อมูล Cosmos DB
Ontology	โทโพโลยี
EventSchemaSet	EventSchemaSet

MirroredDatabase

วัตถุ

รายการฐานข้อมูลแบบมิเรอร์

ชื่อ	พิมพ์	คำอธิบาย
description	string	คําอธิบายสินค้า
displayName	string	ชื่อที่แสดงของรายการ
folderId	string (uuid)	ID โฟลเดอร์
id	string (uuid)	รหัสสินค้า
properties	MirroredDatabaseProperties	คุณสมบัติฐานข้อมูลแบบมิเรอร์
tags	ItemTag[]	รายการของแท็กที่ใช้
type	ItemType	ชนิดหน่วยข้อมูล
workspaceId	string (uuid)	ID พื้นที่ทํางาน

MirroredDatabaseDefinition

วัตถุ

วัตถุข้อกําหนดสาธารณะของฐานข้อมูลแบบมิเรอร์

ชื่อ	พิมพ์	คำอธิบาย
parts	MirroredDatabaseDefinitionPart[]	รายการของส่วนข้อกําหนด

MirroredDatabaseDefinitionPart

วัตถุ

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

ชื่อ	พิมพ์	คำอธิบาย
path	string	เส้นทางส่วนของฐานข้อมูลที่มิเรอร์
payload	string	ส่วนข้อมูลของฐานข้อมูลที่มิเรอร์
payloadType	PayloadType	ชนิดของส่วนข้อมูล

MirroredDatabaseProperties

วัตถุ

คุณสมบัติฐานข้อมูลแบบมิเรอร์

ชื่อ	พิมพ์	คำอธิบาย
defaultSchema	string	เค้าร่างเริ่มต้นของฐานข้อมูลที่มิเรอร์ คุณสมบัตินี้จะถูกส่งกลับสําหรับฐานข้อมูลมิเรอร์ที่เปิดใช้งาน schema เริ่มต้นในข้อกําหนดเท่านั้น
oneLakeTablesPath	string	เส้นทาง OneLake ไปยังไดเรกทอรีตารางฐานข้อมูลที่มิเรอร์
sqlEndpointProperties	SqlEndpointProperties	ออบเจ็กต์ที่ประกอบด้วยคุณสมบัติของจุดสิ้นสุด SQL

PayloadType

การแจงนับ

ชนิดของส่วนข้อกําหนดส่วนข้อมูล อาจมีการเพิ่มชนิดของส่วนข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
InlineBase64	ฐานแบบอินไลน์ 64

SqlEndpointProperties

วัตถุ

ออบเจ็กต์ที่ประกอบด้วยคุณสมบัติของจุดสิ้นสุด SQL

ชื่อ	พิมพ์	คำอธิบาย
connectionString	string	สตริงการเชื่อมต่อปลายทาง SQL
id	string	รหัสจุดสิ้นสุด SQL
provisioningStatus	SqlEndpointProvisioningStatus	สถานะการเตรียมใช้งานจุดสิ้นสุด SQL

SqlEndpointProvisioningStatus

การแจงนับ

ชนิดสถานะการเตรียมใช้งานจุดสิ้นสุด SQL ประเภท SqlEndpointProvisioningStatus เพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
InProgress	กําลังดําเนินการเตรียมใช้งานจุดสิ้นสุด SQL
Success	การเตรียมใช้งานจุดสิ้นสุด SQL สําเร็จ
Failed	การเตรียมใช้งานจุดสิ้นสุด SQL ล้มเหลว