แชร์ผ่าน

Items - Create Eventhouse

  • การอ้างอิง
บริการ:
Eventhouse
เวอร์ชัน API:
v1

สร้างเหตุการณ์ในพื้นที่ทํางานที่ระบุ
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 อักขระ

การตอบสนอง

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

Eventhouse

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

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

ส่วนหัว

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

ErrorResponse

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

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

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

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

ตัวอย่าง

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

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

รหัสสถานะ:
201 
{
  "displayName": "Eventhouse_1",
  "description": "An eventhouse description.",
  "type": "Eventhouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047655"
}
รหัสสถานะ:
202 
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
  }
}

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

รหัสสถานะ:
201 
{
  "displayName": "Eventhouse_1",
  "description": "An eventhouse description.",
  "type": "Eventhouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047655"
}
รหัสสถานะ:
202 
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"
      }
    ]
  }
}

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

รหัสสถานะ:
201 
{
  "displayName": "Eventhouse_1",
  "description": "An eventhouse description.",
  "type": "Eventhouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047655"
}
รหัสสถานะ:
202 
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
ItemType

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

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

CreateEventhouseRequest

ออบเจ็กต์

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

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

EventhouseCreationPayload

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

EventhouseDefinition

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

string

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

string

ชื่อที่แสดงของ 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

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

string

uuid

รหัสสินค้า
properties

EventhouseProperties

คุณสมบัติ eventhouse
type

ItemType

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

string

uuid

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

EventhouseCreationPayload

ออบเจ็กต์

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

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

number

double 		0

เมื่อเปิดใช้งาน แล้ว eventhouse จะพร้อมใช้งานในระดับต่ําสุดที่เลือกเสมอ และคุณจะชําระเงินอย่างน้อยการคํานวณขั้นต่ําที่เลือก ค่าที่ได้รับการสนับสนุนรวมถึง [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

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

string[]

uuid

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

string

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

string

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

ItemType

การแจงนับ

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

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

แดชบอร์ด PowerBI
DataPipeline

ไปป์ไลน์ข้อมูล
Datamart

Datamart ของ PowerBI
Environment

สภาพแวดล้อม
Eventhouse

อาคารจัดงาน
Eventstream

เหตุการณ์กระแสข้อมูล
GraphQLApi

API สําหรับรายการ GraphQL
KQLDashboard

แดชบอร์ด KQL
KQLDatabase

ฐานข้อมูล KQL
KQLQueryset

ชุดคิวรี KQL
Lakehouse

เลคเฮ้าส์
MLExperiment

การทดลองการเรียนรู้ของเครื่อง
MLModel

แบบจําลองการเรียนรู้ของเครื่อง
MirroredDatabase

ฐานข้อมูลที่มิเรอร์
MirroredWarehouse

คลังสินค้าที่มิเรอร์
MountedDataFactory

เมาท์ DataFactory
Notebook

โน๊ตบุ๊ค
PaginatedReport

รายงานที่มีการแบ่งหน้าของ PowerBI
Reflex

รีเฟล็กซ์
Report

รายงาน PowerBI
SQLDatabase

SQLDatabase
SQLEndpoint

จุดสิ้นสุด SQL
SemanticModel

แบบจําลองความหมายของ PowerBI
SparkJobDefinition

ข้อกําหนดงานแบบประกายไฟ
Warehouse

คลังสินค้า

PayloadType

การแจงนับ

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

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

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