Items - Create Spark Job Definition
สร้างข้อกําหนดงานแบบประกายไฟในพื้นที่ทํางานที่ระบุ
API นี้สนับสนุน การดําเนินการที่ใช้เวลานาน (LRO)
หากต้องการสร้างข้อกําหนดงานแบบประกายไฟที่มีข้อกําหนดสาธารณะ โปรดดูที่บทความ ข้อกําหนดงาน Spark
สิทธิ์
ผู้โทรต้องมีบทบาท ผู้สนับสนุน หรือสูงกว่า
จําเป็นต้องมีขอบเขตที่ได้รับมอบสิทธิ์
SparkJobDefinition.ReadWrite.All หรือ Item.ReadWrite.All
ขีด จำกัด
- หากต้องการสร้างข้อกําหนดงาน Spark พื้นที่ทํางานจะต้องอยู่ในความจุ Fabric ที่ได้รับการสนับสนุน สําหรับข้อมูลเพิ่มเติม ดูที่: สิทธิ์การใช้งาน Microsoft Fabric
ข้อมูลประจําตัวที่สนับสนุนของ Microsoft Entra
API นี้สนับสนุนข้อมูลประจําตัวของ Microsoft แสดงรายการในส่วนนี้
เอกลักษณ์ | สนับสนุน |
---|---|
ผู้ใช้ | ใช่ |
บริการหลักและข้อมูลประจําตัว ที่มีการจัดการ | ใช่ |
อิน เทอร์ เฟซ
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/sparkJobDefinitions
พารามิเตอร์ URI
ชื่อ | ใน | จำเป็น | พิมพ์ | คำอธิบาย |
---|---|---|---|---|
workspace
|
path | True |
string uuid |
ID พื้นที่ทํางาน |
เนื้อความของคำขอ
ชื่อ | จำเป็น | พิมพ์ | คำอธิบาย |
---|---|---|---|
displayName | True |
string |
ชื่อที่แสดงข้อกําหนดงานแบบประกายไฟ ชื่อที่แสดงต้องเป็นไปตามกฎการตั้งชื่อตามชนิดหน่วยข้อมูล |
definition |
ข้อกําหนดสาธารณะของงาน Spark |
||
description |
string |
คําอธิบายข้อกําหนดของงาน Spark ความยาวสูงสุดคือ 256 อักขระ |
การตอบสนอง
ชื่อ | พิมพ์ | คำอธิบาย |
---|---|---|
201 Created |
สร้างเสร็จเรียบร้อยแล้ว |
|
202 Accepted |
คําขอที่ยอมรับการเตรียมใช้งานข้อกําหนดงาน Spark อยู่ในระหว่างการดําเนินการ ส่วนหัว
|
|
Other Status Codes |
รหัสข้อผิดพลาดทั่วไป:
|
ตัวอย่าง
Create a spark job definition example |
Create a spark job definition with public definition example |
Create a spark job definition example
คำขอตัวอย่าง
POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/sparkJobDefinitions
{
"displayName": "SparkJobDefinition 1",
"description": "A spark job definition description."
}
คำตอบตัวอย่าง
{
"displayName": "SparkJobDefinition 1",
"description": "A spark job definition description.",
"type": "SparkJobDefinition",
"workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"id": "5b218778-e7a5-4d73-8187-f10824047715"
}
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 spark job definition with public definition example
คำขอตัวอย่าง
POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/sparkJobDefinitions
{
"displayName": "SparkJobDefinition 1",
"description": "A spark job definition description.",
"definition": {
"format": "SparkJobDefinitionV1",
"parts": [
{
"path": "SparkJobDefinitionV1.json",
"payload": "eyJleGVjdXRhYmxlRm..OWRmNDhhY2ZmZTgifQ==",
"payloadType": "InlineBase64"
},
{
"path": ".platform",
"payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
"payloadType": "InlineBase64"
}
]
}
}
คำตอบตัวอย่าง
{
"displayName": "SparkJobDefinition 1",
"description": "A spark job definition description.",
"type": "SparkJobDefinition",
"workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"id": "5b218778-e7a5-4d73-8187-f10824047715"
}
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 |
สร้างส่วนข้อมูลการร้องขอข้อกําหนดงาน Spark |
Error |
ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด |
Error |
การตอบสนองข้อผิดพลาด |
Error |
รายละเอียดการตอบสนองข้อผิดพลาด |
Item |
ชนิดของสินค้า คุณสามารถเพิ่มชนิดหน่วยข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป |
Payload |
ชนิดของส่วนข้อกําหนดส่วนข้อมูล อาจมีการเพิ่มชนิดของส่วนข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป |
Spark |
ออบเจ็กต์ข้อกําหนดงานแบบประกายไฟ |
Spark |
คุณสมบัติข้อกําหนดงาน Spark |
Spark |
วัตถุนิยามสาธารณะข้อกําหนดงาน Spark โปรดดูบทความ นี้ สําหรับรายละเอียดเพิ่มเติมเกี่ยวกับวิธีการสร้างข้อกําหนดสาธารณะของข้อกําหนดงาน Spark |
Spark |
ออบเจ็กต์ส่วนข้อกําหนดของข้อกําหนดงาน Spark |
CreateSparkJobDefinitionRequest
สร้างส่วนข้อมูลการร้องขอข้อกําหนดงาน Spark
ชื่อ | พิมพ์ | คำอธิบาย |
---|---|---|
definition |
ข้อกําหนดสาธารณะของงาน Spark |
|
description |
string |
คําอธิบายข้อกําหนดของงาน Spark ความยาวสูงสุดคือ 256 อักขระ |
displayName |
string |
ชื่อที่แสดงข้อกําหนดงานแบบประกายไฟ ชื่อที่แสดงต้องเป็นไปตามกฎการตั้งชื่อตามชนิดหน่วยข้อมูล |
ErrorRelatedResource
ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
ชื่อ | พิมพ์ | คำอธิบาย |
---|---|---|
resourceId |
string |
ID ทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด |
resourceType |
string |
ชนิดของทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด |
ErrorResponse
การตอบสนองข้อผิดพลาด
ชื่อ | พิมพ์ | คำอธิบาย |
---|---|---|
errorCode |
string |
ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้ |
message |
string |
การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้ |
moreDetails |
รายการรายละเอียดข้อผิดพลาดเพิ่มเติม |
|
relatedResource |
รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด |
|
requestId |
string |
รหัสของคําขอที่เกี่ยวข้องกับข้อผิดพลาด |
ErrorResponseDetails
รายละเอียดการตอบสนองข้อผิดพลาด
ชื่อ | พิมพ์ | คำอธิบาย |
---|---|---|
errorCode |
string |
ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้ |
message |
string |
การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้ |
relatedResource |
รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด |
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 |
SparkJobDefinition
ออบเจ็กต์ข้อกําหนดงานแบบประกายไฟ
ชื่อ | พิมพ์ | คำอธิบาย |
---|---|---|
description |
string |
คําอธิบายสินค้า |
displayName |
string |
ชื่อที่แสดงของรายการ |
id |
string uuid |
รหัสสินค้า |
properties |
คุณสมบัติข้อกําหนดงาน Spark |
|
type |
ชนิดหน่วยข้อมูล |
|
workspaceId |
string uuid |
ID พื้นที่ทํางาน |
SparkJobDefinitionProperties
คุณสมบัติข้อกําหนดงาน Spark
ชื่อ | พิมพ์ | คำอธิบาย |
---|---|---|
oneLakeRootPath |
string |
เส้นทาง OneLake ไปยังไดเรกทอรีรากของ SparkJobDefinition |
SparkJobDefinitionPublicDefinition
วัตถุนิยามสาธารณะข้อกําหนดงาน Spark โปรดดูบทความ นี้ สําหรับรายละเอียดเพิ่มเติมเกี่ยวกับวิธีการสร้างข้อกําหนดสาธารณะของข้อกําหนดงาน Spark
ชื่อ | พิมพ์ | คำอธิบาย |
---|---|---|
format |
string |
รูปแบบของข้อกําหนดหน่วยข้อมูล รูปแบบที่ได้รับการสนับสนุน: |
parts |
รายการของส่วนข้อกําหนด |
SparkJobDefinitionPublicDefinitionPart
ออบเจ็กต์ส่วนข้อกําหนดของข้อกําหนดงาน Spark
ชื่อ | พิมพ์ | คำอธิบาย |
---|---|---|
path |
string |
เส้นทางส่วนคําจํากัดความสาธารณะของข้อกําหนดงาน Spark |
payload |
string |
ส่วนข้อกําหนดสาธารณะของข้อกําหนดงาน Spark |
payloadType |
ชนิดของส่วนข้อมูล |