Items - Get Queryable Graph Type (beta)

Layanan:

GraphModel

Versi API:

v1

Dapatkan jenis grafik yang dapat dikueri saat ini.

Nota

Item GraphModel saat ini dalam Pratinjau (pelajari lebih lanjut). API ini adalah bagian dari rilis Beta dan disediakan hanya untuk tujuan evaluasi dan pengembangan. Ini dapat berubah berdasarkan umpan balik dan tidak disarankan untuk penggunaan produksi. Saat memanggil API ini, penelepon harus menentukan true sebagai nilai untuk parameter beta kueri (preview parameter kueri telah digantikan oleh beta. Untuk kompatibilitas mundur, preview masih didukung dan berprilaku sama seperti beta).

API ini mendukung penomoran halaman.

Permissions

Pemanggil harus memiliki peran ruang kerja penampil . Pemanggil harus memiliki izin baca untuk model grafik.

Cakupan yang Didelegasikan yang Diperlukan

Workspace.Read.All atau Workspace.ReadWrite.All

Microsoft Entra identitas yang didukung

API ini mendukung identitas Microsoft yang tercantum di bagian ini.

Identitas	Support
Pengguna	Yes
Prinsipal Layanan dan Identitas Terkelola	Yes

Antarmuka

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
graphModelId	path	True	string (uuid)	ID GraphModel.
workspaceId	path	True	string (uuid)	ID ruangkerja.
beta	query	True	boolean	Parameter yang diperlukan ini harus diatur ke true untuk mengakses API ini, yang saat ini dalam versi beta.

Respons

Nama	Jenis	Deskripsi
200 OK	GraphType	Jenis grafik yang dapat dikueri saat ini.
429 Too Many Requests	ErrorResponse	Batas tarif layanan terlampaui. Server mengembalikan header yang Retry-After menunjukkan, dalam detik, berapa lama klien harus menunggu sebelum mengirim permintaan tambahan. Header Retry-After: integer
Other Status Codes	ErrorResponse	Kode kesalahan umum: ItemNotFound - Item yang diminta tidak ditemukan.

Contoh

Get queryable graph type example

Permintaan sampel

HTTP

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

Respon sampel

Kode status:

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": []
    }
  ]
}

Definisi

Nama	Deskripsi
EdgeType	Jenis tepi grafik.
ErrorRelatedResource	Objek detail sumber daya terkait kesalahan.
ErrorResponse	Respons kesalahan.
ErrorResponseDetails	Detail respons kesalahan.
GraphType	Jenis grafik yang menentukan struktur grafik.
NodeType	Jenis node grafik.
NodeTypeReference	Referensi ke jenis node.
Property	Properti elemen grafik.

EdgeType

Objek

Jenis tepi grafik.

Nama	Jenis	Deskripsi
alias	string	Alias jenis tepi.
destinationNodeType	NodeTypeReference	Jenis simpul target.
labels	string[]	Label jenis tepi.
properties	Property[]	Daftar properti tipe tepi.
sourceNodeType	NodeTypeReference	Jenis node sumber.

ErrorRelatedResource

Objek

Objek detail sumber daya terkait kesalahan.

Nama	Jenis	Deskripsi
resourceId	string	ID sumber daya yang terlibat dalam kesalahan.
resourceType	string	Jenis sumber daya yang terlibat dalam kesalahan.

ErrorResponse

Objek

Respons kesalahan.

Nama	Jenis	Deskripsi
errorCode	string	Pengidentifikasi tertentu yang menyediakan informasi tentang kondisi kesalahan, memungkinkan komunikasi standar antara layanan kami dan penggunanya.
isRetriable	boolean	Jika benar, permintaan dapat dicoba kembali. Retry-After Gunakan header respons untuk menentukan penundaan, jika tersedia.
message	string	Representasi kesalahan yang dapat dibaca manusia.
moreDetails	ErrorResponseDetails[]	Daftar detail kesalahan tambahan.
relatedResource	ErrorRelatedResource	Detail sumber daya terkait kesalahan.
requestId	string (uuid)	ID permintaan yang terkait dengan kesalahan.

ErrorResponseDetails

Objek

Detail respons kesalahan.

Nama	Jenis	Deskripsi
errorCode	string	Pengidentifikasi tertentu yang menyediakan informasi tentang kondisi kesalahan, memungkinkan komunikasi standar antara layanan kami dan penggunanya.
message	string	Representasi kesalahan yang dapat dibaca manusia.
relatedResource	ErrorRelatedResource	Detail sumber daya terkait kesalahan.

GraphType

Objek

Jenis grafik yang menentukan struktur grafik.

Nama	Jenis	Deskripsi
edgeTypes	EdgeType[]	Daftar jenis tepi grafik.
nodeTypes	NodeType[]	Daftar jenis node grafik.

NodeType

Objek

Jenis node grafik.

Nama	Jenis	Deskripsi
alias	string	Alias jenis node.
labels	string[]	Label jenis node.
primaryKeyProperties	string[]	Daftar properti kunci utama jenis node.
properties	Property[]	Daftar properti jenis node.

NodeTypeReference

Objek

Referensi ke jenis node.

Nama	Jenis	Deskripsi
alias	string	Alias jenis node.

Property

Objek

Properti elemen grafik.

Nama	Jenis	Deskripsi
name	string	Nama properti.
type	string	Jenis properti.