แชร์ผ่าน

Tables - Load Table

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

เริ่มต้นการดําเนินการโหลดตารางและแสดง URL สถานะการดําเนินการในส่วนหัวของตําแหน่งที่ตั้งการตอบสนอง

Note

API นี้เป็นส่วนหนึ่งของการเผยแพร่ตัวอย่าง และมีไว้เพื่อวัตถุประสงค์ในการประเมินและการพัฒนาเท่านั้น ซึ่งอาจเปลี่ยนแปลงตามคําติชมและไม่แนะนําสําหรับการใช้งานด้านการผลิต

API นี้สนับสนุน การดําเนินการที่ใช้เวลานาน (LRO)

Permissions

เขียนสิทธิ์ในการเข้าถึงรายการของเลคเฮ้าส์

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

Lakehouse.ReadWrite.All

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

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

Identity Support
User Yes
บริการหลักและข้อมูลประจําตัว ที่มีการจัดการ Yes

Interface

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/lakehouses/{lakehouseId}/tables/{tableName}/load

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

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

string (uuid)

ID รายการเลคเฮ้าส์
tableName
 path True

string

pattern: ^(?=[0-9]*[a-zA-Z_])[a-zA-Z0-9_]{1,256}$

ชื่อตาราง
workspaceId
 path True

string (uuid)

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

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

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

PathType

ชนิดของ relativePathไฟล์หรือโฟลเดอร์ ประเภท PathType เพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป
relativePath True

string

pattern: ^Files(\/[\p{L}\w]{1}([ \p{L}\w\.-]*[\p{L}\w\.-]{1})*)*$

เส้นทางสัมพัทธ์ของไฟล์หรือโฟลเดอร์ข้อมูล
fileExtension

string

pattern: ^[a-zA-Z0-9_-]{1,16}$

นามสกุลไฟล์ของไฟล์ข้อมูล
formatOptions FileFormatOptions:

ชนิดนามธรรมของตัวเลือกรูปแบบไฟล์ข้อมูล
mode

ModeType

โหมดการดําเนินการโหลดตาราง เขียนทับ หรือผนวก คุณสามารถเพิ่มชนิดโหมดเพิ่มเติมเมื่อเวลาผ่านไป
recursive

boolean

ระบุว่า จะค้นหาไฟล์ข้อมูลซ้ําหรือไม่ เมื่อโหลดตารางจากโฟลเดอร์

การตอบสนอง

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

คําขอที่ยอมรับ การดําเนินการโหลดตารางกําลังอยู่ระหว่างดําเนินการ

ส่วนหัว

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

ErrorResponse

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

  • UnknownError - เกิดข้อผิดพลาด

ตัวอย่าง

Load table operation Example

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

POST https://api.fabric.microsoft.com/v1/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/lakehouses/41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87/tables/abc123/load

{
  "relativePath": "Files/abc/abc123.csv",
  "pathType": "File",
  "mode": "Overwrite",
  "recursive": false,
  "formatOptions": {
    "format": "Csv",
    "header": true,
    "delimiter": ","
  }
}

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

รหัสสถานะ:
202 
Location: https://api.fabric.microsoft.com/v1/operations/abcdef00-9d7e-469a-abf1-fca847a0ea69
x-ms-operation-id: abcdef00-9d7e-469a-abf1-fca847a0ea69
Retry-After: 30

คำจำกัดความ

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

ตัวเลือกรูปแบบ CSV สําหรับไฟล์ CSV
ErrorRelatedResource

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

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

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

แสดงคําขอการดําเนินการโหลดตาราง
ModeType

โหมดการดําเนินการโหลดตาราง เขียนทับ หรือผนวก คุณสามารถเพิ่มชนิดโหมดเพิ่มเติมเมื่อเวลาผ่านไป
Parquet

ตัวเลือกรูปแบบสําหรับไฟล์ Parquet
PathType

ชนิดของ relativePathไฟล์หรือโฟลเดอร์ ประเภท PathType เพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป

Csv

ออบเจ็กต์

ตัวเลือกรูปแบบ CSV สําหรับไฟล์ CSV

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

string

pattern: ^[^\(\)\[\]\{\}'""]{0,8}$

ตัวคั่นของไฟล์ CSV
format string:

Csv

ชื่อรูปแบบไฟล์ข้อมูล ประเภทรูปแบบไฟล์เพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป
header

boolean

คุณสมบัตินี้ระบุว่าไฟล์ข้อมูล CSV มีบรรทัดส่วนหัวหรือไม่

ErrorRelatedResource

ออบเจ็กต์

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

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

string

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

string

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

ErrorResponse

ออบเจ็กต์

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

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

string

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

string

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

ErrorResponseDetails[]

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

ErrorRelatedResource

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

string

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

ErrorResponseDetails

ออบเจ็กต์

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

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

string

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

string

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

ErrorRelatedResource

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

LoadTableRequest

ออบเจ็กต์

แสดงคําขอการดําเนินการโหลดตาราง

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

string

pattern: ^[a-zA-Z0-9_-]{1,16}$

นามสกุลไฟล์ของไฟล์ข้อมูล
formatOptions FileFormatOptions:

ชนิดนามธรรมของตัวเลือกรูปแบบไฟล์ข้อมูล
mode

ModeType

โหมดการดําเนินการโหลดตาราง เขียนทับ หรือผนวก คุณสามารถเพิ่มชนิดโหมดเพิ่มเติมเมื่อเวลาผ่านไป
pathType

PathType

ชนิดของ relativePathไฟล์หรือโฟลเดอร์ ประเภท PathType เพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป
recursive

boolean

ระบุว่า จะค้นหาไฟล์ข้อมูลซ้ําหรือไม่ เมื่อโหลดตารางจากโฟลเดอร์
relativePath

string

pattern: ^Files(\/[\p{L}\w]{1}([ \p{L}\w\.-]*[\p{L}\w\.-]{1})*)*$

เส้นทางสัมพัทธ์ของไฟล์หรือโฟลเดอร์ข้อมูล

ModeType

การแจงนับ

โหมดการดําเนินการโหลดตาราง เขียนทับ หรือผนวก คุณสามารถเพิ่มชนิดโหมดเพิ่มเติมเมื่อเวลาผ่านไป

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

โหลดตารางในโหมดเขียนทับ
Append

โหลดตารางในโหมดผนวก

Parquet

ออบเจ็กต์

ตัวเลือกรูปแบบสําหรับไฟล์ Parquet

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

Parquet

ชื่อรูปแบบไฟล์ข้อมูล ประเภทรูปแบบไฟล์เพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป

PathType

การแจงนับ

ชนิดของ relativePathไฟล์หรือโฟลเดอร์ ประเภท PathType เพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป

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

โหลดตารางจากไฟล์
Folder

โหลดตารางจากโฟลเดอร์