Items - Get Lakehouse

การอ้างอิง

บริการ:: Lakehouse

เวอร์ชัน API:: v1

ส่งกลับคุณสมบัติของเลคเฮ้าส์ที่ระบุ

สิทธิ์

ผู้เรียกต้องมีบทบาท ของผู้ชม หรือสูงกว่าพื้นที่ทํางาน

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

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

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

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

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

อิน เทอร์ เฟซ

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

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

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

การตอบสนอง

ชื่อ	พิมพ์	คำอธิบาย
200 OK	Lakehouse	คําขอเสร็จสมบูรณ์
Other Status Codes	ErrorResponse	รหัสข้อผิดพลาดทั่วไป: ItemNotFound - ไม่พบรายการที่ร้องขอ

ชื่อ

พิมพ์

คำอธิบาย

200 OK

Lakehouse

คําขอเสร็จสมบูรณ์

Other Status Codes

ErrorResponse

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

ItemNotFound - ไม่พบรายการที่ร้องขอ

ตัวอย่าง

Get a lakehouse example

Get a lakehouse with schema example

Get a lakehouse example

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

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/lakehouses/5b218778-e7a5-4d73-8187-f10824047715

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

รหัสสถานะ:: 200

{
  "displayName": "Lakehouse_1",
  "description": "A lakehouse description.",
  "type": "Lakehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715",
  "properties": {
    "oneLakeTablesPath": "https://onelake.dfs.fabric.microsoft.com/2382cdf5-d577-44d0-a1fc-42184f29a7eb/e5fb215b-1934-413e-b33a-debaf844afde/Tables",
    "oneLakeFilesPath": "https://onelake.dfs.fabric.microsoft.com/2382cdf5-d577-44d0-a1fc-42184f29a7eb/e5fb215b-1934-413e-b33a-debaf844afde/Files",
    "sqlEndpointProperties": {
      "connectionString": "qvrmbuxie7we7glrekxgy6npqu-6xgyei3x2xiejip4iime6knh5m.datawarehouse.fabric.microsoft.com",
      "id": "37dc8a41-dea9-465d-b528-3e95043b2356",
      "provisioningStatus": "Success"
    }
  }
}

Get a lakehouse with schema example

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

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/lakehouses/5b218778-e7a5-4d73-8187-f10824047715

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

รหัสสถานะ:: 200

{
  "displayName": "Lakehouse_created_with_schema",
  "description": "A schema enabled lakehouse.",
  "type": "Lakehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715",
  "properties": {
    "oneLakeTablesPath": "https://onelake.dfs.fabric.microsoft.com/2382cdf5-d577-44d0-a1fc-42184f29a7eb/e5fb215b-1934-413e-b33a-debaf844afde/Tables",
    "oneLakeFilesPath": "https://onelake.dfs.fabric.microsoft.com/2382cdf5-d577-44d0-a1fc-42184f29a7eb/e5fb215b-1934-413e-b33a-debaf844afde/Files",
    "sqlEndpointProperties": {
      "connectionString": "qvrmbuxie7we7glrekxgy6npqu-6xgyei3x2xiejip4iime6knh5m.datawarehouse.fabric.microsoft.com",
      "id": "37dc8a41-dea9-465d-b528-3e95043b2356",
      "provisioningStatus": "Success"
    },
    "defaultSchema": "dbo"
  }
}

คำจำกัดความ

ชื่อ	คำอธิบาย
ErrorRelatedResource	ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
ErrorResponse	การตอบสนองข้อผิดพลาด
ErrorResponseDetails	รายละเอียดการตอบสนองข้อผิดพลาด
ItemType	ชนิดของสินค้า คุณสามารถเพิ่มชนิดหน่วยข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป
Lakehouse	ของบ้านในทะเลสาบ
LakehouseProperties	ที่ให้บริการของเลคเฮ้าส์
SqlEndpointProperties	ออบเจ็กต์ที่ประกอบด้วยคุณสมบัติของจุดสิ้นสุด SQL
SqlEndpointProvisioningStatus	ชนิดสถานะการเตรียมใช้งานจุดสิ้นสุด SQL ประเภท `SqlEndpointProvisioningStatus` เพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป

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 พื้นที่ทํางาน

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 สําเร็จ

แชร์ผ่าน

Items - Get Lakehouse

สิทธิ์

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

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

อิน เทอร์ เฟซ

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

การตอบสนอง

ตัวอย่าง

Get a lakehouse example

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

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

Get a lakehouse with schema example

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

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

คำจำกัดความ

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ItemType

Lakehouse

LakehouseProperties

SqlEndpointProperties

SqlEndpointProvisioningStatus

แหล่งทรัพยากรเพิ่มเติม