Items - Get Queryable Graph Type (beta)

Hizmet:

GraphModel

API Sürümü:

v1

Geçerli sorgulanabilir grafik türünü alın.

Uyarı

GraphModel öğesi şu anda Önizleme aşamasındadır (daha fazla bilgi edinin). Bu API, Beta sürümünün bir parçasıdır ve yalnızca değerlendirme ve geliştirme amacıyla sağlanır. Geri bildirim temelinde değişebilir ve üretim kullanımı için önerilmez. Bu API'yi çağırırken, çağıranların sorgu parametresinin true değeri olarak belirtmesi beta gerekir (preview sorgu parametresi ile betadeğiştirilmiştir. Geriye dönük uyumluluk için hala preview desteklenir ve ile aynı betaşekilde davranır.

Bu API, sayfalandırmadestekler.

Permissions

Çağıranın bir görüntüleyici çalışma alanı rolü olmalıdır. Çağıranın grafik modeli için okuma izinlerine sahip olması gerekir.

Gerekli Temsilci Kapsamları

Workspace.Read.All veya Workspace.ReadWrite.All

Desteklenen kimlikleri Microsoft Entra

Bu API, bu bölümde listelenen Microsoft kimliklerini destekler.

Kimlik	Support
User	Yes
Hizmet sorumlusu ve yönetilen kimlikler	Yes

Arayüz

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
graphModelId	path	True	string (uuid)	GraphModel Kimliği.
workspaceId	path	True	string (uuid)	Çalışma alanı kimliği.
beta	query	True	boolean	Şu anda beta sürümünde olan bu API'ye erişmek için bu gerekli parametre olarak ayarlanmalıdır true .

Yanıtlar

Name	Tür	Description
200 OK	GraphType	Geçerli sorgulanabilir grafik türü.
429 Too Many Requests	ErrorResponse	Hizmet fiyatı sınırı aşıldı. Sunucu, istemcinin ek istek göndermeden önce ne kadar beklemesi gerektiğini saniye cinsinden belirten bir Retry-After üst bilgi döndürür. Üst Bilgiler Retry-After: integer
Other Status Codes	ErrorResponse	Yaygın hata kodları: ItemNotFound - İstenen öğe bulunamadı.

Örnekler

Get queryable graph type example

Örnek isteği

HTTP

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

Örnek yanıt

Durum kodu:

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

Tanımlar

Name	Description
EdgeType	Grafik kenar türü.
ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.
GraphType	Grafın yapısını belirten grafik türü.
NodeType	Grafik düğümü türü.
NodeTypeReference	Düğüm türüne başvuru.
Property	Graph öğesi özelliği.

EdgeType

Nesne

Grafik kenar türü.

Name	Tür	Description
alias	string	Kenar türü diğer adı.
destinationNodeType	NodeTypeReference	Hedef düğüm türü.
labels	string[]	Kenar türü etiketleri.
properties	Property[]	Kenar türü özelliklerinin listesi.
sourceNodeType	NodeTypeReference	Kaynak düğüm türü.

ErrorRelatedResource

Nesne

Hatayla ilgili kaynak ayrıntıları nesnesi.

Name	Tür	Description
resourceId	string	Hataya dahil olan kaynak kimliği.
resourceType	string	Hataya dahil olan kaynağın türü.

ErrorResponse

Nesne

Hata yanıtı.

Name	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
isRetriable	boolean	True olduğunda istek yeniden denenebilir. Varsa gecikmeyi Retry-After belirlemek için yanıt üst bilgisini kullanın.
message	string	Hatanın okunabilir bir gösterimi.
moreDetails	ErrorResponseDetails[]	Ek hata ayrıntılarının listesi.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.
requestId	string (uuid)	Hatayla ilişkili isteğin kimliği.

ErrorResponseDetails

Nesne

Hata yanıtı ayrıntıları.

Name	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message	string	Hatanın okunabilir bir gösterimi.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.

GraphType

Nesne

Grafın yapısını belirten grafik türü.

Name	Tür	Description
edgeTypes	EdgeType[]	Grafik kenar türlerinin listesi.
nodeTypes	NodeType[]	Grafik düğümü türlerinin listesi.

NodeType

Nesne

Grafik düğümü türü.

Name	Tür	Description
alias	string	Düğüm türü diğer adı.
labels	string[]	Düğüm türü etiketleri.
primaryKeyProperties	string[]	Düğüm türü birincil anahtar özelliklerinin listesi.
properties	Property[]	Düğüm türü özelliklerinin listesi.

NodeTypeReference

Nesne

Düğüm türüne başvuru.

Name	Tür	Description
alias	string	Düğüm türü diğer adı.

Property

Nesne

Graph öğesi özelliği.

Name	Tür	Description
name	string	Özellik adı.
type	string	Özellik türü.