Items - Get Queryable Graph Type (beta)

サービス:: GraphModel

API バージョン:: v1

現在のクエリ可能なグラフの種類を取得します。

注

GraphModel 項目は現在プレビュー段階です (詳細については、こちらをご覧ください)。この API はベータリリースの一部であり、評価と開発のみを目的として提供されます。フィードバックに基づいて変更される可能性があり、運用環境での使用はお勧めしません。この API を呼び出すとき、呼び出し元はクエリパラメーター trueの値としてbetaを指定する必要があります (previewクエリパラメーターはbetaに置き換えられました。下位互換性のために、previewは引き続きサポートされており、beta) と同じように動作します。

この API では、改ページ位置の修正がサポートされています。

Permissions

呼び出し元には ビューアー ワークスペースロールが必要です。呼び出し元には、グラフモデルの 読み取り アクセス許可が必要です。

必要な委任されたスコープ

Workspace.Read.All または Workspace.ReadWrite.All

Microsoft Entra でサポートされている ID

この API では、このセクションに記載されている Microsoft ID がサポートされています。

アイデンティティ	Support
ユーザー	イエス
サービスプリンシパルとマネージド ID	いいえ

インターフェイス

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

URI パラメーター

名前	/	必須	型	説明
GraphModelId	path	True	string (uuid)	GraphModel ID。
workspaceId	path	True	string (uuid)	ワークスペース ID。
beta	query	True	boolean	この API にアクセスするには、この必須パラメーターを `true` に設定する必要があります。これは現在ベータ版です。

応答

名前型説明

200 OK

名前	型	説明
200 OK	GraphType	現在のクエリ可能なグラフの種類。
429 Too Many Requests	ErrorResponse	サービスレートの制限を超えました。サーバーは、クライアントが追加の要求を送信するまでに待機する必要がある時間を秒単位で示す `Retry-After` ヘッダーを返します。ヘッダー Retry-After: integer
Other Status Codes	ErrorResponse	一般的なエラーコード: ItemNotFound - 要求された項目が見つかりませんでした。

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

Object

グラフのエッジの種類。

名前	型	説明
alias	string	エッジの種類のエイリアス。
destinationNodeType	NodeTypeReference	ターゲットノードの種類。
labels	string[]	エッジの種類のラベル。
properties	Property[]	エッジの種類のプロパティの一覧。
sourceNodeType	NodeTypeReference	ソースノードの種類。

ErrorRelatedResource

Object

エラー関連のリソース詳細オブジェクト。

名前	型	説明
resourceId	string	エラーに関係するリソース ID。
resourceType	string	エラーに関係するリソースの種類。

ErrorResponse

Object

エラー応答。

名前	型	説明
errorCode	string	エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。
message	string	エラーの人間が判読できる表現。
moreDetails	ErrorResponseDetails[]	その他のエラーの詳細の一覧。
relatedResource	ErrorRelatedResource	エラー関連のリソースの詳細。
requestId	string (uuid)	エラーに関連付けられている要求の ID。

ErrorResponseDetails

Object

エラー応答の詳細。

名前	型	説明
errorCode	string	エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。
message	string	エラーの人間が判読できる表現。
relatedResource	ErrorRelatedResource	エラー関連のリソースの詳細。

GraphType

Object

グラフの構造を指定するグラフの種類。

名前	型	説明
edgeTypes	EdgeType[]	グラフエッジの種類の一覧。
nodeTypes	NodeType[]	グラフノードの種類の一覧。

NodeType

Object

グラフノードの種類。

名前	型	説明
alias	string	ノードの種類のエイリアス。
labels	string[]	ノードの種類のラベル。
primaryKeyProperties	string[]	ノードタイプの主キープロパティの一覧。
properties	Property[]	ノードの種類のプロパティの一覧。

NodeTypeReference

Object

ノードの種類への参照。

名前	型	説明
alias	string	ノードの種類のエイリアス。

Property

Object

グラフ要素のプロパティ。

名前	型	説明
name	string	プロパティ名。
type	string	プロパティの種類。

次の方法で共有

Items - Get Queryable Graph Type (beta)

Permissions

必要な委任されたスコープ

Microsoft Entra でサポートされている ID

インターフェイス

URI パラメーター

応答

例

Get queryable graph type example

要求のサンプル

応答のサンプル

定義

EdgeType

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

GraphType

NodeType

NodeTypeReference

Property