แชร์ผ่าน


Items - Create Eventhouse

สร้างเหตุการณ์ในพื้นที่ทํางานที่ระบุ
API นี้สนับสนุน การดําเนินการที่ใช้เวลานาน (LRO)

สิทธิ์

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

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

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

ขีด จำกัด

  • ในการสร้าง eventhouse พื้นที่ทํางานต้องอยู่บนความจุ Fabric ที่ได้รับการสนับสนุน สําหรับข้อมูลเพิ่มเติม ดูที่: สิทธิ์การใช้งาน Microsoft Fabric

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

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

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

อิน เทอร์ เฟซ

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

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

ชื่อ ใน จำเป็น พิมพ์ คำอธิบาย
workspaceId
path True

string (uuid)

ID พื้นที่ทํางาน

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

ชื่อ จำเป็น พิมพ์ คำอธิบาย
displayName True

string

ชื่อที่แสดงของ eventhouse ชื่ออีเวนต์สามารถประกอบด้วยอักขระพยัญชนะผสมตัวเลข ขีดล่าง จุด และเครื่องหมายยัติภังค์ ไม่รองรับอักขระพิเศษ

creationPayload

EventhouseCreationPayload

ส่วนข้อมูลการสร้างเหตุการณ์ ใช้ definition หรือ creationPayload คุณไม่สามารถใช้ทั้งสองอย่างในเวลาเดียวกัน

definition

EventhouseDefinition

ข้อกําหนดสาธารณะของ eventhouse ใช้ definition หรือ creationPayload คุณไม่สามารถใช้ทั้งสองอย่างในเวลาเดียวกัน

description

string

คําอธิบายของ eventhouse ความยาวสูงสุดคือ 256 อักขระ

folderId

string (uuid)

ID โฟลเดอร์ ถ้าไม่ได้ระบุหรือเป็น null eventhouse จะถูกสร้างขึ้นด้วยพื้นที่ทํางานเป็นโฟลเดอร์

การตอบสนอง

ชื่อ พิมพ์ คำอธิบาย
201 Created

Eventhouse

สร้างเสร็จเรียบร้อยแล้ว

202 Accepted

คําขอที่ยอมรับ กําลังดําเนินการเตรียมใช้งาน eventhouse

ส่วนหัว

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

รหัสข้อผิดพลาดทั่วไป:

  • InvalidItemType - ชนิดรายการไม่ถูกต้อง

  • ItemDisplayNameAlreadyInUse - ชื่อที่ใช้แสดงรายการถูกใช้แล้ว

  • CorruptedPayload - ส่วนข้อมูลที่ให้มาเสียหาย

  • WorkspaceItemsLimitExceeded - เกินขีดจํากัดของรายการพื้นที่ทํางาน

ตัวอย่าง

Create an eventhouse example
create an eventhouse with creationPayload example
Create an eventhouse with definition example

Create an eventhouse example

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

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/eventhouses

{
  "displayName": "Eventhouse_1",
  "description": "An eventhouse description."
}

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

{
  "displayName": "Eventhouse_1",
  "description": "An eventhouse description.",
  "type": "Eventhouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047655"
}
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

create an eventhouse with creationPayload example

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

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/eventhouses

{
  "displayName": "Eventhouse_1",
  "description": "An eventhouse description.",
  "creationPayload": {
    "minimumConsumptionUnits": 2.25
  }
}

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

{
  "displayName": "Eventhouse_1",
  "description": "An eventhouse description.",
  "type": "Eventhouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047655"
}
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Create an eventhouse with definition example

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

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/eventhouses

{
  "displayName": "Eventhouse_1",
  "description": "An eventhouse description.",
  "definition": {
    "parts": [
      {
        "path": "EventhouseProperties.json",
        "payload": "e30=",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

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

{
  "displayName": "Eventhouse_1",
  "description": "An eventhouse description.",
  "type": "Eventhouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047655"
}
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

คำจำกัดความ

ชื่อ คำอธิบาย
CreateEventhouseRequest

สร้างคําขอของ eventhouse

ErrorRelatedResource

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

ErrorResponse

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

ErrorResponseDetails

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

Eventhouse

วัตถุของ eventhouse

EventhouseCreationPayload

ส่วนข้อมูลรายการอีเวนต์เฮ้าส์

EventhouseDefinition

วัตถุนิยามสาธารณะของ Eventhouse

EventhouseDefinitionPart

วัตถุส่วนของข้อกําหนดเหตุการณ์

EventhouseProperties

คุณสมบัติ eventhouse

ItemTag

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

ItemType

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

PayloadType

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

CreateEventhouseRequest

สร้างคําขอของ eventhouse

ชื่อ พิมพ์ คำอธิบาย
creationPayload

EventhouseCreationPayload

ส่วนข้อมูลการสร้างเหตุการณ์ ใช้ definition หรือ creationPayload คุณไม่สามารถใช้ทั้งสองอย่างในเวลาเดียวกัน

definition

EventhouseDefinition

ข้อกําหนดสาธารณะของ eventhouse ใช้ definition หรือ creationPayload คุณไม่สามารถใช้ทั้งสองอย่างในเวลาเดียวกัน

description

string

คําอธิบายของ eventhouse ความยาวสูงสุดคือ 256 อักขระ

displayName

string

ชื่อที่แสดงของ eventhouse ชื่ออีเวนต์สามารถประกอบด้วยอักขระพยัญชนะผสมตัวเลข ขีดล่าง จุด และเครื่องหมายยัติภังค์ ไม่รองรับอักขระพิเศษ

folderId

string (uuid)

ID โฟลเดอร์ ถ้าไม่ได้ระบุหรือเป็น null eventhouse จะถูกสร้างขึ้นด้วยพื้นที่ทํางานเป็นโฟลเดอร์

ErrorRelatedResource

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

ชื่อ พิมพ์ คำอธิบาย
resourceId

string

ID ทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

resourceType

string

ชนิดของทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponse

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

ชื่อ พิมพ์ คำอธิบาย
errorCode

string

ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้

message

string

การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้

moreDetails

ErrorResponseDetails[]

รายการรายละเอียดข้อผิดพลาดเพิ่มเติม

relatedResource

ErrorRelatedResource

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

requestId

string

รหัสของคําขอที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponseDetails

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

ชื่อ พิมพ์ คำอธิบาย
errorCode

string

ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้

message

string

การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้

relatedResource

ErrorRelatedResource

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

Eventhouse

วัตถุของ eventhouse

ชื่อ พิมพ์ คำอธิบาย
description

string

คําอธิบายสินค้า

displayName

string

ชื่อที่แสดงของรายการ

folderId

string (uuid)

ID โฟลเดอร์

id

string (uuid)

รหัสสินค้า

properties

EventhouseProperties

คุณสมบัติ eventhouse

tags

ItemTag[]

รายการของแท็กที่ใช้

type

ItemType

ชนิดหน่วยข้อมูล

workspaceId

string (uuid)

ID พื้นที่ทํางาน

EventhouseCreationPayload

ส่วนข้อมูลรายการอีเวนต์เฮ้าส์

ชื่อ พิมพ์ Default value คำอธิบาย
minimumConsumptionUnits

number (double)

0

ใช้การบริโภคต่ําสุดสําหรับระบบที่ไวต่อเวลาสูงเพื่อให้บริการพร้อมใช้งานในระดับต่ําสุดที่เลือกอยู่เสมอ คุณชําระเงินสําหรับระดับปริมาณการใช้ต่ําสุดหรือปริมาณการใช้จริงถ้าสูงกว่าค่าต่ําสุด ค่าที่ได้รับการสนับสนุนรวมถึง [0, 2.25, 4.25, 8.5, 13, 18, 26, 34, 50] หรือตัวเลขใดๆ ระหว่าง 51 และ 322 สําหรับข้อมูลเพิ่มเติม ให้ดูที่ ปริมาณการใช้ขั้นต่ํา

EventhouseDefinition

วัตถุนิยามสาธารณะของ Eventhouse

ชื่อ พิมพ์ คำอธิบาย
format

string

รูปแบบของข้อกําหนดหน่วยข้อมูล

parts

EventhouseDefinitionPart[]

รายการของส่วนข้อกําหนด

EventhouseDefinitionPart

วัตถุส่วนของข้อกําหนดเหตุการณ์

ชื่อ พิมพ์ คำอธิบาย
path

string

เส้นทางส่วนของ eventhouse

payload

string

ส่วนของ eventhouse

payloadType

PayloadType

ชนิดของส่วนข้อมูล

EventhouseProperties

คุณสมบัติ eventhouse

ชื่อ พิมพ์ Default value คำอธิบาย
databasesItemIds

string[] (uuid)

รายการโหนดลูกของฐานข้อมูล KQL ทั้งหมด

ingestionServiceUri

string

URI บริการการนําเข้า

minimumConsumptionUnits

number (double)

0

ใช้การบริโภคต่ําสุดสําหรับระบบที่ไวต่อเวลาสูงเพื่อให้บริการพร้อมใช้งานในระดับต่ําสุดที่เลือกอยู่เสมอ คุณชําระเงินสําหรับระดับปริมาณการใช้ต่ําสุดหรือปริมาณการใช้จริงถ้าสูงกว่าค่าต่ําสุด ค่าที่ได้รับการสนับสนุนรวมถึง [0, 2.25, 4.25, 8.5, 13, 18, 26, 34, 50] หรือตัวเลขใดๆ ระหว่าง 51 และ 322 สําหรับข้อมูลเพิ่มเติม ให้ดูที่ ปริมาณการใช้ขั้นต่ํา

queryServiceUri

string

URI ของบริการคิวรี

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

PayloadType

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

ค่า คำอธิบาย
InlineBase64

ฐานแบบอินไลน์ 64