Items - Get Queryable Graph Type (beta)

Serviço:: GraphModel

Versão da API:: v1

Obtenha o tipo de grafo atual queryable.

Observação

O item GraphModel está atualmente em versão prévia (saiba mais). Essa API faz parte de uma versão Beta e é fornecida apenas para fins de avaliação e desenvolvimento. Ele pode mudar com base nos comentários e não é recomendado para uso em produção. Ao chamar essa API, os chamadores devem especificar true como o valor do parâmetro beta de consulta (preview o parâmetro de consulta foi substituído por beta. Para compatibilidade com versões anteriores, preview ainda há suporte e se comporta da mesma betaforma que ).

Essa API dá suporte a de paginação.

Permissions

O chamador deve ter uma função de workspace do visualizador . O chamador deve ter permissões de leitura para o modelo de grafo.

Escopos delegados necessários

Workspace.Read.All ou Workspace.ReadWrite.All

Microsoft Entra identidades com suporte

Esta API dá suporte às identidades do Microsoft listadas nesta seção.

Identidade	Support
Utilizador	Yes
Entidade de serviço e identidades gerenciadas	Yes

Interfase

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
graphModelId	path	True	string (uuid)	A ID do GraphModel.
workspaceId	path	True	string (uuid)	O identificador do espaço de trabalho.
beta	query	True	boolean	Esse parâmetro necessário deve ser definido para `true` acessar essa API, que está atualmente em beta.

Respostas

Nome Tipo Description

200 OK

Nome	Tipo	Description
200 OK	GraphType	O tipo de grafo atual queryable.
429 Too Many Requests	ErrorResponse	O limite de taxa de serviço foi excedido. O servidor retorna um `Retry-After` cabeçalho indicando, em segundos, quanto tempo o cliente deve aguardar antes de enviar solicitações 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 grafo atual queryable.

429 Too Many Requests

ErrorResponse

O limite de taxa de serviço foi excedido. O servidor retorna um Retry-After cabeçalho indicando, em segundos, quanto tempo o cliente deve aguardar antes de enviar solicitações 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

Solicitação de exemplo

HTTP

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

Resposta de exemplo

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

Definições

Nome	Description
EdgeType	Um tipo de borda de grafo.
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 grafo que especifica a estrutura de um grafo.
NodeType	Um tipo de nó de grafo.
NodeTypeReference	Uma referência a um tipo de nó.
Property	Uma propriedade de elemento de grafo.

EdgeType

Objeto

Um tipo de borda de grafo.

Nome	Tipo	Description
alias	string	O alias de 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

Objeto

O objeto de detalhes do recurso relacionado ao erro.

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

ErrorResponse

Objeto

A resposta de erro.

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

ErrorResponseDetails

Objeto

Os detalhes da resposta de erro.

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

GraphType

Objeto

O tipo de grafo que especifica a estrutura de um grafo.

Nome	Tipo	Description
edgeTypes	EdgeType[]	Uma lista de tipos de borda de grafo.
nodeTypes	NodeType[]	Uma lista de tipos de nó de grafo.

NodeType

Objeto

Um tipo de nó de grafo.

Nome	Tipo	Description
alias	string	O alias de 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

Objeto

Uma referência a um tipo de nó.

Nome	Tipo	Description
alias	string	O alias de tipo de nó.

Property

Objeto

Uma propriedade de elemento de grafo.

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

Compartilhar via

Items - Get Queryable Graph Type (beta)

Permissions

Escopos delegados necessários

Microsoft Entra identidades com suporte

Interfase

Parâmetros de URI

Respostas

Exemplos

Get queryable graph type example

Solicitação de exemplo

Resposta de exemplo

Definições

EdgeType

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

GraphType

NodeType

NodeTypeReference

Property