Items - Get Queryable Graph Type (beta)

Serviço:: GraphModel

Versão da API:: v1

Obtenha o tipo de gráfico consultável atual.

Observação

O item GraphModel está atualmente em Pré-visualização (saiba mais). Esta API faz parte de uma versão Beta e é fornecida apenas para fins de avaliação e desenvolvimento. Ele pode mudar com base no feedback e não é recomendado para uso em produção. Ao chamar esta API, os chamadores devem especificar true como valor para o parâmetro beta de consulta (preview o parâmetro de consulta foi substituído por beta. Para compatibilidade retroativa, preview continua a ser suportado e comporta-se da mesma forma que beta).

Esta API suporta paginação.

Permissions

O chamador deve ter uma função de espaço de trabalho de visualizador . O chamador deve ter permissões de leitura para o modelo de gráfico.

Escopos delegados necessários

Workspace.Read.All ou Workspace.ReadWrite.All

Identidades suportadas pela Microsoft Entra

Esta API suporta as identidades do Microsoft listadas nesta secção.

Identidade	Support
User	Yes
Entidade de serviço e identidades geridas	Yes

Interfaz

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
graphModelId	path	True	string (uuid)	O ID do GraphModel.
workspaceId	path	True	string (uuid)	O ID do espaço de trabalho.
beta	query	True	boolean	Este parâmetro exigido deve ser definido para `true` aceder a esta API, que está atualmente em beta.

Respostas

Name Tipo Description

200 OK

Name	Tipo	Description
200 OK	GraphType	O tipo de gráfico consultável atual.
429 Too Many Requests	ErrorResponse	O limite de tarifa de serviço foi ultrapassado. O servidor devolve um `Retry-After` cabeçalho que indica, em segundos, quanto tempo o cliente deve esperar antes de enviar pedidos adicionais. Cabeçalhos Retry-After: integer
Other Status Codes	ErrorResponse	Códigos de erro comuns: ItemNotFound - O item solicitado não foi encontrado.

GraphType

O tipo de gráfico consultável atual.

429 Too Many Requests

ErrorResponse

O limite de tarifa de serviço foi ultrapassado. O servidor devolve um Retry-After cabeçalho que indica, em segundos, quanto tempo o cliente deve esperar antes de enviar pedidos adicionais.

Cabeçalhos

Retry-After: integer

Other Status Codes

ErrorResponse

Códigos de erro comuns:

ItemNotFound - O item solicitado não foi encontrado.

Exemplos

Get queryable graph type example

Pedido de amostra

HTTP

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

Resposta da amostra

Código de estado:: 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": []
    }
  ]
}

Definições

Name	Description
EdgeType	Um tipo de borda de gráfico.
ErrorRelatedResource	O objeto de detalhes do recurso relacionado ao erro.
ErrorResponse	A resposta de erro.
ErrorResponseDetails	Os detalhes da resposta de erro.
GraphType	O tipo de gráfico que especifica a estrutura de um gráfico.
NodeType	Um tipo de nó gráfico.
NodeTypeReference	Uma referência a um tipo de nó.
Property	Uma propriedade de elemento gráfico.

EdgeType

Object

Um tipo de borda de gráfico.

Name	Tipo	Description
alias	string	O alias do tipo de borda.
destinationNodeType	NodeTypeReference	O tipo de nó de destino.
labels	string[]	Os rótulos de tipo de borda.
properties	Property[]	Uma lista de propriedades de tipo de borda.
sourceNodeType	NodeTypeReference	O tipo de nó de origem.

ErrorRelatedResource

Object

O objeto de detalhes do recurso relacionado ao erro.

Name	Tipo	Description
resourceId	string	A ID do recurso envolvida no erro.
resourceType	string	O tipo de recurso envolvido no erro.

ErrorResponse

Object

A resposta de erro.

Name	Tipo	Description
errorCode	string	Um identificador específico que fornece informações sobre uma condição de erro, permitindo uma comunicação padronizada entre nosso serviço e seus usuários.
message	string	Uma representação legível por humanos do erro.
moreDetails	ErrorResponseDetails[]	Lista de detalhes de erro adicionais.
relatedResource	ErrorRelatedResource	Os detalhes do recurso relacionados ao erro.
requestId	string (uuid)	ID da solicitação associada ao erro.

ErrorResponseDetails

Object

Os detalhes da resposta de erro.

Name	Tipo	Description
errorCode	string	Um identificador específico que fornece informações sobre uma condição de erro, permitindo uma comunicação padronizada entre nosso serviço e seus usuários.
message	string	Uma representação legível por humanos do erro.
relatedResource	ErrorRelatedResource	Os detalhes do recurso relacionados ao erro.

GraphType

Object

O tipo de gráfico que especifica a estrutura de um gráfico.

Name	Tipo	Description
edgeTypes	EdgeType[]	Uma lista de tipos de borda de gráfico.
nodeTypes	NodeType[]	Uma lista de tipos de nós gráficos.

NodeType

Object

Um tipo de nó gráfico.

Name	Tipo	Description
alias	string	O alias do tipo de nó.
labels	string[]	Os rótulos de tipo de nó.
primaryKeyProperties	string[]	Uma lista de propriedades de chave primária do tipo de nó.
properties	Property[]	Uma lista de propriedades de tipo de nó.

NodeTypeReference

Object

Uma referência a um tipo de nó.

Name	Tipo	Description
alias	string	O alias do tipo de nó.

Property

Object

Uma propriedade de elemento gráfico.

Name	Tipo	Description
name	string	O nome da propriedade.
type	string	O tipo de propriedade.

Partilhar via

Items - Get Queryable Graph Type (beta)

Permissions

Escopos delegados necessários

Identidades suportadas pela Microsoft Entra

Interfaz

Parâmetros do URI

Respostas

Exemplos

Get queryable graph type example

Pedido de amostra

Resposta da amostra

Definições

EdgeType

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

GraphType

NodeType

NodeTypeReference

Property