แชร์ผ่าน


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

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

string

uuid

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

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

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

string

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

definition

SparkJobDefinitionPublicDefinition

ข้อกําหนดสาธารณะของงาน Spark

description

string

คําอธิบายข้อกําหนดของงาน Spark ความยาวสูงสุดคือ 256 อักขระ

การตอบสนอง

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

SparkJobDefinition

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

202 Accepted

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

ส่วนหัว

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

ErrorResponse

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

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

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

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

ตัวอย่าง

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

คำจำกัดความ

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

สร้างส่วนข้อมูลการร้องขอข้อกําหนดงาน Spark

ErrorRelatedResource

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

ErrorResponse

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

ErrorResponseDetails

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

ItemType

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

PayloadType

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

SparkJobDefinition

ออบเจ็กต์ข้อกําหนดงานแบบประกายไฟ

SparkJobDefinitionProperties

คุณสมบัติข้อกําหนดงาน Spark

SparkJobDefinitionPublicDefinition

วัตถุนิยามสาธารณะข้อกําหนดงาน Spark โปรดดูบทความ นี้ สําหรับรายละเอียดเพิ่มเติมเกี่ยวกับวิธีการสร้างข้อกําหนดสาธารณะของข้อกําหนดงาน Spark

SparkJobDefinitionPublicDefinitionPart

ออบเจ็กต์ส่วนข้อกําหนดของข้อกําหนดงาน Spark

CreateSparkJobDefinitionRequest

สร้างส่วนข้อมูลการร้องขอข้อกําหนดงาน Spark

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

SparkJobDefinitionPublicDefinition

ข้อกําหนดสาธารณะของงาน Spark

description

string

คําอธิบายข้อกําหนดของงาน Spark ความยาวสูงสุดคือ 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

คลังสินค้า

PayloadType

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

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

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

SparkJobDefinition

ออบเจ็กต์ข้อกําหนดงานแบบประกายไฟ

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

string

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

displayName

string

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

id

string

uuid

รหัสสินค้า

properties

SparkJobDefinitionProperties

คุณสมบัติข้อกําหนดงาน Spark

type

ItemType

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

workspaceId

string

uuid

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

SparkJobDefinitionProperties

คุณสมบัติข้อกําหนดงาน Spark

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

string

เส้นทาง OneLake ไปยังไดเรกทอรีรากของ SparkJobDefinition

SparkJobDefinitionPublicDefinition

วัตถุนิยามสาธารณะข้อกําหนดงาน Spark โปรดดูบทความ นี้ สําหรับรายละเอียดเพิ่มเติมเกี่ยวกับวิธีการสร้างข้อกําหนดสาธารณะของข้อกําหนดงาน Spark

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

string

รูปแบบของข้อกําหนดหน่วยข้อมูล รูปแบบที่ได้รับการสนับสนุน: SparkJobDefinitionV1

parts

SparkJobDefinitionPublicDefinitionPart[]

รายการของส่วนข้อกําหนด

SparkJobDefinitionPublicDefinitionPart

ออบเจ็กต์ส่วนข้อกําหนดของข้อกําหนดงาน Spark

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

string

เส้นทางส่วนคําจํากัดความสาธารณะของข้อกําหนดงาน Spark

payload

string

ส่วนข้อกําหนดสาธารณะของข้อกําหนดงาน Spark

payloadType

PayloadType

ชนิดของส่วนข้อมูล