แชร์ผ่าน

Items - Create Lakehouse

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

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

API นี้ไม่สนับสนุนการสร้าง lakehouse ที่มีข้อกําหนด

สิทธิ์

ผู้โทรต้องมีบทบาท ผู้สนับสนุน หรือสูงกว่า

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

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

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

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

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

อิน เทอร์ เฟซ

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

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

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

string

uuid

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

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

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

string

ชื่อที่แสดงของเลคเฮ้าส์ ชื่อที่แสดงต้องเป็นไปตามกฎการตั้งชื่อตามชนิดหน่วยข้อมูล
creationPayload

LakehouseCreationPayload

การสร้างเพย์โหลดของเลคเฮ้าส์
description

string

รายละเอียดของเลคเฮ้าส์ ความยาวสูงสุดคือ 256 อักขระ

การตอบสนอง

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

Lakehouse

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

คําขอได้รับการยอมรับ การเตรียมใช้งาน lakehouse อยู่ในระหว่างการดําเนินการ

ส่วนหัว

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

ErrorResponse

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

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

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

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

ตัวอย่าง

Create a lakehouse example
Create a lakehouse with schema example

Create a lakehouse example

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

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

{
  "displayName": "Lakehouse_1",
  "description": "A lakehouse description"
}

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

รหัสสถานะ:
201 
{
  "displayName": "Lakehouse_1",
  "description": "A lakehouse description",
  "type": "Lakehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}
รหัสสถานะ:
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 a lakehouse with schema example

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

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

{
  "displayName": "Lakehouse_created_with_schema",
  "description": "A schema enabled lakehouse.",
  "creationPayload": {
    "enableSchemas": true
  }
}

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

รหัสสถานะ:
201 
{
  "displayName": "Lakehouse_created_with_schema",
  "description": "A schema enabled lakehouse.",
  "type": "Lakehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}
รหัสสถานะ:
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

คำจำกัดความ

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

สร้างส่วนข้อมูลคําขอของ lakehouse
ErrorRelatedResource

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

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

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

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

ของบ้านในทะเลสาบ
LakehouseCreationPayload

(ตัวอย่าง) เพย์โหลดของเลคเฮ้าส์ คุณสมบัตินี้เป็นสิ่งจําเป็นเนื่องจาก lakehouse ที่เปิดใช้งาน schema กําลังอยู่ในช่วงการแสดงตัวอย่าง ซึ่งอาจกลายเป็นรายการซ้ําซ้อนตามความพร้อมใช้งานทั่วไป (GA)
LakehouseProperties

ที่ให้บริการของเลคเฮ้าส์
SqlEndpointProperties

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

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

CreateLakehouseRequest

ออบเจ็กต์

สร้างส่วนข้อมูลคําขอของ lakehouse

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

LakehouseCreationPayload

การสร้างเพย์โหลดของเลคเฮ้าส์
description

string

รายละเอียดของเลคเฮ้าส์ ความยาวสูงสุดคือ 256 อักขระ
displayName

string

ชื่อที่แสดงของเลคเฮ้าส์ ชื่อที่แสดงต้องเป็นไปตามกฎการตั้งชื่อตามชนิดหน่วยข้อมูล

ErrorRelatedResource

ออบเจ็กต์

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

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

string

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

string

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

ErrorResponse

ออบเจ็กต์

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

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

string

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

string

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

ErrorResponseDetails[]

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

ErrorRelatedResource

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

string

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

ErrorResponseDetails

ออบเจ็กต์

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

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

string

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

string

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

ErrorRelatedResource

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

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

คลังสินค้า

Lakehouse

ออบเจ็กต์

ของบ้านในทะเลสาบ

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

string

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

string

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

string

uuid

รหัสสินค้า
properties

LakehouseProperties

ที่ให้บริการของเลคเฮ้าส์
type

ItemType

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

string

uuid

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

LakehouseCreationPayload

ออบเจ็กต์

(ตัวอย่าง) เพย์โหลดของเลคเฮ้าส์ คุณสมบัตินี้เป็นสิ่งจําเป็นเนื่องจาก lakehouse ที่เปิดใช้งาน schema กําลังอยู่ในช่วงการแสดงตัวอย่าง ซึ่งอาจกลายเป็นรายการซ้ําซ้อนตามความพร้อมใช้งานทั่วไป (GA)

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

boolean

สร้าง schema เปิดใช้งานเลคเฮ้าส์เมื่อตั้งค่าเป็น จริง อนุญาตเฉพาะ 'true' เท่านั้น

LakehouseProperties

ออบเจ็กต์

ที่ให้บริการของเลคเฮ้าส์

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

string

สคีมาเริ่มต้นของเลคเฮ้าส์ คุณสมบัตินี้จะถูกส่งกลับสําหรับ schema ที่เปิดใช้งาน lakehouse เท่านั้น
oneLakeFilesPath

string

เส้นทาง OneLake ไปยังไดเรกทอรีไฟล์ของเลคเฮ้าส์
oneLakeTablesPath

string

เส้นทาง OneLake ไปยังไดเรกทอรีตารางของเลคเฮ้าส์
sqlEndpointProperties

SqlEndpointProperties

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

SqlEndpointProperties

ออบเจ็กต์

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

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

string

สตริงการเชื่อมต่อปลายทาง SQL
id

string

รหัสจุดสิ้นสุด SQL
provisioningStatus

SqlEndpointProvisioningStatus

สถานะการเตรียมใช้งานจุดสิ้นสุด SQL

SqlEndpointProvisioningStatus

การแจงนับ

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

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

การเตรียมใช้งานจุดสิ้นสุด SQL ล้มเหลว
InProgress

กําลังดําเนินการเตรียมใช้งานจุดสิ้นสุด SQL
Success

การเตรียมใช้งานจุดสิ้นสุด SQL สําเร็จ