Items - Get Queryable Graph Type (beta)

บริการ:

GraphModel

เวอร์ชัน API:

v1

รับชนิดกราฟที่สามารถคิวรีได้ในปัจจุบัน

Note

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

API นี้สนับสนุน การแบ่งหน้า

การอนุญาต

ผู้เรียกต้องมีบทบาทพื้นที่ทํางานของผู้ชม ผู้เรียกต้องมีสิทธิ์ การอ่าน สําหรับแบบจําลองกราฟ

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

Workspace.Read.All หรือ Workspace.ReadWrite.All

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

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

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

อินเตอร์เฟซ

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/GraphModels/{GraphModelId}/getQueryableGraphType?beta={beta}

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

ชื่อ	ใน	จำเป็น	พิมพ์	คำอธิบาย
GraphModelId	path	True	string (uuid)	ID ของ GraphModel
workspaceId	path	True	string (uuid)	ID พื้นที่ทํางาน
beta	query	True	boolean	ต้องตั้งค่าพารามิเตอร์ที่จําเป็นนี้เพื่อ true เข้าถึง API นี้ ซึ่งอยู่ในรุ่นเบต้าในขณะนี้

การตอบสนอง

ชื่อ	พิมพ์	คำอธิบาย
200 OK	GraphType	ชนิดกราฟที่สามารถคิวรีได้ในปัจจุบัน
429 Too Many Requests	ErrorResponse	เกินขีดจํากัดอัตราการบริการ เซิร์ฟเวอร์จะส่งกลับ Retry-After ส่วนหัวที่ระบุ ภายในไม่กี่วินาที ระยะเวลาที่ไคลเอ็นต์ต้องรอก่อนที่จะส่งคําขอเพิ่มเติม ส่วนหัว Retry-After: integer
Other Status Codes	ErrorResponse	รหัสข้อผิดพลาดทั่วไป: ItemNotFound - ไม่พบรายการที่ร้องขอ

ตัวอย่าง

Get queryable graph type example

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

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/GraphModels/41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87/getQueryableGraphType?beta=True

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

รหัสสถานะ:

200

{
  "nodeTypes": [
    {
      "alias": "096a5133-fd82-4000-ac8a-404532ab6fd6",
      "primaryKeyProperties": [
        "customerIDK"
      ],
      "labels": [
        "customer"
      ],
      "properties": [
        {
          "name": "customerIDK",
          "type": "INT"
        },
        {
          "name": "firstName",
          "type": "STRING"
        },
        {
          "name": "lastName",
          "type": "STRING"
        },
        {
          "name": "fullName",
          "type": "STRING"
        }
      ]
    },
    {
      "alias": "dced4642-b93d-4da4-815c-a171932043a4",
      "primaryKeyProperties": [
        "productIDK"
      ],
      "labels": [
        "products"
      ],
      "properties": [
        {
          "name": "productIDK",
          "type": "INT"
        },
        {
          "name": "productNumber",
          "type": "STRING"
        },
        {
          "name": "productName",
          "type": "STRING"
        },
        {
          "name": "modelName",
          "type": "STRING"
        },
        {
          "name": "makeFlag",
          "type": "INT"
        },
        {
          "name": "standardCost",
          "type": "FLOAT"
        },
        {
          "name": "listPrice",
          "type": "FLOAT"
        },
        {
          "name": "subCategoryIDFK",
          "type": "INT"
        }
      ]
    }
  ],
  "edgeTypes": [
    {
      "alias": "3ef6a474-ef38-4923-abcf-6f2e9230f1eb",
      "labels": [
        "customerProducts"
      ],
      "sourceNodeType": {
        "alias": "096a5133-fd82-4000-ac8a-404532ab6fd6"
      },
      "destinationNodeType": {
        "alias": "dced4642-b93d-4da4-815c-a171932043a4"
      },
      "properties": []
    }
  ]
}

คำจำกัดความ

ชื่อ	คำอธิบาย
EdgeType	ชนิดขอบกราฟ
ErrorRelatedResource	ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
ErrorResponse	การตอบสนองข้อผิดพลาด
ErrorResponseDetails	รายละเอียดการตอบสนองข้อผิดพลาด
GraphType	ชนิดกราฟที่ระบุโครงสร้างของกราฟ
NodeType	ชนิดโหนดกราฟ
NodeTypeReference	การอ้างอิงถึงชนิดโหนด
Property	คุณสมบัติองค์ประกอบของกราฟ

EdgeType

วัตถุ

ชนิดขอบกราฟ

ชื่อ	พิมพ์	คำอธิบาย
alias	string	นามแฝงของชนิดขอบ
destinationNodeType	NodeTypeReference	ชนิดโหนดเป้าหมาย
labels	string[]	ป้ายกํากับประเภทขอบ
properties	Property[]	รายการของคุณสมบัติชนิดขอบ
sourceNodeType	NodeTypeReference	ชนิดโหนดต้นทาง

ErrorRelatedResource

วัตถุ

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

ชื่อ	พิมพ์	คำอธิบาย
resourceId	string	ID ทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
resourceType	string	ชนิดของทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponse

วัตถุ

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

ชื่อ	พิมพ์	คำอธิบาย
errorCode	string	ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
message	string	การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
moreDetails	ErrorResponseDetails[]	รายการรายละเอียดข้อผิดพลาดเพิ่มเติม
relatedResource	ErrorRelatedResource	รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
requestId	string (uuid)	รหัสของคําขอที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponseDetails

วัตถุ

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

ชื่อ	พิมพ์	คำอธิบาย
errorCode	string	ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
message	string	การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
relatedResource	ErrorRelatedResource	รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

GraphType

วัตถุ

ชนิดกราฟที่ระบุโครงสร้างของกราฟ

ชื่อ	พิมพ์	คำอธิบาย
edgeTypes	EdgeType[]	รายการของชนิดขอบกราฟ
nodeTypes	NodeType[]	รายการชนิดโหนดกราฟ

NodeType

วัตถุ

ชนิดโหนดกราฟ

ชื่อ	พิมพ์	คำอธิบาย
alias	string	นามแฝงของชนิดโหนด
labels	string[]	ป้ายชื่อชนิดโหนด
primaryKeyProperties	string[]	รายการคุณสมบัติคีย์หลักของชนิดโหนด
properties	Property[]	รายการคุณสมบัติชนิดโหนด

NodeTypeReference

วัตถุ

การอ้างอิงถึงชนิดโหนด

ชื่อ	พิมพ์	คำอธิบาย
alias	string	นามแฝงของชนิดโหนด

Property

วัตถุ

คุณสมบัติองค์ประกอบของกราฟ

ชื่อ	พิมพ์	คำอธิบาย
name	string	ชื่อคุณสมบัติ
type	string	ชนิดของคุณสมบัติ