แชร์ผ่าน

Items - Discover Dataflow Parameters

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

เรียกใช้พารามิเตอร์ทั้งหมดที่กําหนดไว้ในกระแสข้อมูลที่ระบุ

สิทธิ์

ผู้เรียกต้องมีสิทธิ์ ในการอ่าน กระแสข้อมูล

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

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

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

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

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

อิน เทอร์ เฟซ

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/dataflows/{dataflowId}/parameters
ด้วยพารามิเตอร์ที่เลือกได้: 
GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/dataflows/{dataflowId}/parameters?continuationToken={continuationToken}

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

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

string (uuid)

ID กระแสข้อมูล
workspaceId
 path True

string (uuid)

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

string

โทเค็นสําหรับการเรียกใช้หน้าถัดไปของผลลัพธ์

การตอบสนอง

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

DataflowParameters

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

ErrorResponse

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

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

  • DataflowNotParametricError - กระแสข้อมูลที่ร้องขอไม่ใช่พารามิเตอร์

ตัวอย่าง

Get Dataflow Parameters example

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

GET https://api.fabric.microsoft.com/v1/workspaces/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/dataflows/dddddddd-9999-0000-1111-eeeeeeeeeeee/parameters

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

รหัสสถานะ:
200 
{
  "value": [
    {
      "name": "manufacturer",
      "isRequired": true,
      "description": "Manufacturer of the item",
      "type": "String",
      "defaultValue": "test-value"
    },
    {
      "name": "isImported",
      "isRequired": false,
      "description": "Is the item imported",
      "type": "Boolean",
      "defaultValue": true
    },
    {
      "name": "quantity",
      "isRequired": false,
      "description": "Quantity of item",
      "type": "Integer",
      "defaultValue": 123456789
    },
    {
      "name": "weightThreshold",
      "isRequired": true,
      "description": "Weight threshold for item",
      "type": "Number",
      "defaultValue": 3.14
    },
    {
      "name": "datetimeOfOrder",
      "isRequired": true,
      "description": "Datetime of order",
      "type": "DateTime",
      "defaultValue": "2025-09-15T21:45:00.000Z"
    },
    {
      "name": "datetimeZoneOfOrder",
      "isRequired": true,
      "description": "DatetimeZone of order",
      "type": "DateTimeZone",
      "defaultValue": "2025-09-15T21:45:00+02:00"
    },
    {
      "name": "dateOfImport",
      "isRequired": true,
      "description": "Date of import",
      "type": "Date",
      "defaultValue": "2025-09-15"
    },
    {
      "name": "timeOfImport",
      "isRequired": true,
      "description": "Time of import",
      "type": "Time",
      "defaultValue": "21:45:00"
    },
    {
      "name": "durationOfImport",
      "isRequired": true,
      "description": "Duration of import",
      "type": "Duration",
      "defaultValue": "P5DT21H35M30S"
    }
  ]
}

คำจำกัดความ

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

พารามิเตอร์กระแสข้อมูลชนิดบูลีน
DataflowDateParameter

พารามิเตอร์กระแสข้อมูลชนิดวันที่ สตริงในรูปแบบ yyyy-MM-dd (ตัวอย่าง: 2025-09-15 สําหรับวันที่ 15 กันยายน 2025) ใช้ชนิด "อัตโนมัติ" เพื่อแทนที่พารามิเตอร์ประเภทนี้เมื่อดําเนินการกับกระแสข้อมูล
DataflowDateTimeParameter

พารามิเตอร์กระแสข้อมูลชนิด DateTime สตริงในรูปแบบ yyyy-MM-ddTHH:mm:ss.xxxZ (ตัวอย่าง: 2025-09-15T21:45:00.000Z)
DataflowDateTimeZoneParameter

พารามิเตอร์กระแสข้อมูลชนิด DateTimeZone สตริงในรูปแบบ yyyy-MM-ddTHH:mm:sszzz (ตัวอย่าง: 2025-09-15T21:45:00+02:00) ใช้ชนิด "อัตโนมัติ" เพื่อแทนที่พารามิเตอร์ประเภทนี้เมื่อดําเนินการกับกระแสข้อมูล
DataflowDurationParameter

พารามิเตอร์กระแสข้อมูลชนิดระยะเวลา สตริงในรูปแบบ \Pd\DTH\Hm\Ms\S (ตัวอย่าง: P5DT14H35M30S เป็นเวลา 5 วัน 14 ชั่วโมง 35 นาทีและ 30 วินาที) ใช้ชนิด "อัตโนมัติ" เพื่อแทนที่พารามิเตอร์ประเภทนี้เมื่อดําเนินการกับกระแสข้อมูล
DataflowIntegerParameter

พารามิเตอร์กระแสข้อมูลชนิดยาว
DataflowNumberParameter

พารามิเตอร์กระแสข้อมูลเป็นชนิดคู่
DataflowParameters

รายการพารามิเตอร์ของกระแสข้อมูล
DataflowStringParameter

พารามิเตอร์กระแสข้อมูลชนิดสตริง
DataflowTimeParameter

พารามิเตอร์กระแสข้อมูลชนิดเวลา สตริงในรูปแบบ HH:mm:ss (ตัวอย่าง: 21:45:00 สําหรับ 9:45 PM) ใช้ชนิด "อัตโนมัติ" เพื่อแทนที่พารามิเตอร์ประเภทนี้เมื่อดําเนินการกับกระแสข้อมูล
ErrorRelatedResource

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

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

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

DataflowBooleanParameter

ออบเจ็กต์

พารามิเตอร์กระแสข้อมูลชนิดบูลีน

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

boolean

ค่าที่จะมีการรีเฟรชพารามิเตอร์หากไม่มีการระบุเมื่อดําเนินการกระแสข้อมูล
description

string

คําอธิบายของพารามิเตอร์
isRequired

boolean

ระบุว่าต้องการพารามิเตอร์หรือไม่
name

string

ชื่อของพารามิเตอร์
type string:

Boolean

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

DataflowDateParameter

ออบเจ็กต์

พารามิเตอร์กระแสข้อมูลชนิดวันที่ สตริงในรูปแบบ yyyy-MM-dd (ตัวอย่าง: 2025-09-15 สําหรับวันที่ 15 กันยายน 2025) ใช้ชนิด "อัตโนมัติ" เพื่อแทนที่พารามิเตอร์ประเภทนี้เมื่อดําเนินการกับกระแสข้อมูล

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

string

ค่าที่จะมีการรีเฟรชพารามิเตอร์หากไม่มีการระบุเมื่อดําเนินการกระแสข้อมูล
description

string

คําอธิบายของพารามิเตอร์
isRequired

boolean

ระบุว่าต้องการพารามิเตอร์หรือไม่
name

string

ชื่อของพารามิเตอร์
type string:

Date

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

DataflowDateTimeParameter

ออบเจ็กต์

พารามิเตอร์กระแสข้อมูลชนิด DateTime สตริงในรูปแบบ yyyy-MM-ddTHH:mm:ss.xxxZ (ตัวอย่าง: 2025-09-15T21:45:00.000Z)

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

string (date-time)

ค่าที่จะมีการรีเฟรชพารามิเตอร์หากไม่มีการระบุเมื่อดําเนินการกระแสข้อมูล
description

string

คําอธิบายของพารามิเตอร์
isRequired

boolean

ระบุว่าต้องการพารามิเตอร์หรือไม่
name

string

ชื่อของพารามิเตอร์
type string:

DateTime

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

DataflowDateTimeZoneParameter

ออบเจ็กต์

พารามิเตอร์กระแสข้อมูลชนิด DateTimeZone สตริงในรูปแบบ yyyy-MM-ddTHH:mm:sszzz (ตัวอย่าง: 2025-09-15T21:45:00+02:00) ใช้ชนิด "อัตโนมัติ" เพื่อแทนที่พารามิเตอร์ประเภทนี้เมื่อดําเนินการกับกระแสข้อมูล

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

string

ค่าที่จะมีการรีเฟรชพารามิเตอร์หากไม่มีการระบุเมื่อดําเนินการกระแสข้อมูล
description

string

คําอธิบายของพารามิเตอร์
isRequired

boolean

ระบุว่าต้องการพารามิเตอร์หรือไม่
name

string

ชื่อของพารามิเตอร์
type string:

DateTimeZone

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

DataflowDurationParameter

ออบเจ็กต์

พารามิเตอร์กระแสข้อมูลชนิดระยะเวลา สตริงในรูปแบบ \Pd\DTH\Hm\Ms\S (ตัวอย่าง: P5DT14H35M30S เป็นเวลา 5 วัน 14 ชั่วโมง 35 นาทีและ 30 วินาที) ใช้ชนิด "อัตโนมัติ" เพื่อแทนที่พารามิเตอร์ประเภทนี้เมื่อดําเนินการกับกระแสข้อมูล

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

string

ค่าที่จะมีการรีเฟรชพารามิเตอร์หากไม่มีการระบุเมื่อดําเนินการกระแสข้อมูล
description

string

คําอธิบายของพารามิเตอร์
isRequired

boolean

ระบุว่าต้องการพารามิเตอร์หรือไม่
name

string

ชื่อของพารามิเตอร์
type string:

Duration

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

DataflowIntegerParameter

ออบเจ็กต์

พารามิเตอร์กระแสข้อมูลชนิดยาว

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

integer (int64)

ค่าที่จะมีการรีเฟรชพารามิเตอร์หากไม่มีการระบุเมื่อดําเนินการกระแสข้อมูล
description

string

คําอธิบายของพารามิเตอร์
isRequired

boolean

ระบุว่าต้องการพารามิเตอร์หรือไม่
name

string

ชื่อของพารามิเตอร์
type string:

Integer

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

DataflowNumberParameter

ออบเจ็กต์

พารามิเตอร์กระแสข้อมูลเป็นชนิดคู่

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

number (double)

ค่าที่จะมีการรีเฟรชพารามิเตอร์หากไม่มีการระบุเมื่อดําเนินการกระแสข้อมูล
description

string

คําอธิบายของพารามิเตอร์
isRequired

boolean

ระบุว่าต้องการพารามิเตอร์หรือไม่
name

string

ชื่อของพารามิเตอร์
type string:

Number

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

DataflowParameters

ออบเจ็กต์

รายการพารามิเตอร์ของกระแสข้อมูล

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

string

โทเค็นสําหรับชุดผลลัพธ์ชุดถัดไป ถ้าไม่มีระเบียนเพิ่มเติม จะถูกลบออกจากการตอบสนอง
continuationUri

string

URI ของชุดงานชุดผลลัพธ์ถัดไป ถ้าไม่มีระเบียนเพิ่มเติม จะถูกลบออกจากการตอบสนอง
value DataflowParameter[]:

รายการพารามิเตอร์ที่กําหนดไว้ในกระแสข้อมูล

DataflowStringParameter

ออบเจ็กต์

พารามิเตอร์กระแสข้อมูลชนิดสตริง

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

string

ค่าที่จะมีการรีเฟรชพารามิเตอร์หากไม่มีการระบุเมื่อดําเนินการกระแสข้อมูล
description

string

คําอธิบายของพารามิเตอร์
isRequired

boolean

ระบุว่าต้องการพารามิเตอร์หรือไม่
name

string

ชื่อของพารามิเตอร์
type string:

String

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

DataflowTimeParameter

ออบเจ็กต์

พารามิเตอร์กระแสข้อมูลชนิดเวลา สตริงในรูปแบบ HH:mm:ss (ตัวอย่าง: 21:45:00 สําหรับ 9:45 PM) ใช้ชนิด "อัตโนมัติ" เพื่อแทนที่พารามิเตอร์ประเภทนี้เมื่อดําเนินการกับกระแสข้อมูล

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

string

ค่าที่จะมีการรีเฟรชพารามิเตอร์หากไม่มีการระบุเมื่อดําเนินการกระแสข้อมูล
description

string

คําอธิบายของพารามิเตอร์
isRequired

boolean

ระบุว่าต้องการพารามิเตอร์หรือไม่
name

string

ชื่อของพารามิเตอร์
type string:

Time

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

ErrorRelatedResource

ออบเจ็กต์

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

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

string

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

string

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

ErrorResponse

ออบเจ็กต์

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

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

string

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

string

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

ErrorResponseDetails[]

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

ErrorRelatedResource

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

string

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

ErrorResponseDetails

ออบเจ็กต์

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

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

string

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

string

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

ErrorRelatedResource

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