Items - Get Queryable Graph Type (beta)

Υπηρεσία:: GraphModel

Έκδοση API:: v1

Λάβετε τον τρέχοντα τύπο γραφήματος με δυνατότητα ερωτήματος.

Σημείωμα

Το στοιχείο GraphModel είναι αυτήν τη στιγμή σε έκδοση προεπισκόπησης (μάθετε περισσότερα). Αυτό το API αποτελεί μέρος μιας έκδοσης Beta και παρέχεται μόνο για σκοπούς αξιολόγησης και ανάπτυξης. Μπορεί να αλλάξει με βάση τα σχόλια και δεν συνιστάται για χρήση στην παραγωγή. Κατά την κλήση αυτού του API, οι καλούντες πρέπει να καθορίσουν true ως τιμή για την παράμετρο beta ερωτήματος (preview η παράμετρος ερωτήματος έχει αντικατασταθεί από betaτο . Για συμβατότητα με προηγούμενες εκδόσεις, preview εξακολουθεί να υποστηρίζεται και συμπεριφέρεται όμοια με betaτο ).

Αυτό το API υποστηρίζει σελιδοποίησης .

Δικαιώματα

Ο καλών πρέπει να έχει ρόλο θεατή. Ο καλών πρέπει να έχει δικαιώματα ανάγνωσης για το μοντέλο γραφήματος.

Απαιτούμενες εμβέλειες με ανάθεση

Workspace.Read.All ή Workspace.ReadWrite.All

υποστηριζόμενες ταυτότητες Microsoft Entra

Αυτό το API υποστηρίζει τις ταυτότητες Microsoft που παρατίθενται σε αυτή την ενότητα.

Ταυτότητα	Υποστήριξη
User	Ναι
Υπηρεσίας και διαχειριζόμενες ταυτότητες	Ναι

Διασύνδεση

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

Παράμετροι URI

Ονομασία	Σε	Απαιτείται	Τύπος	Περιγραφή
graphModelId	path	True	string (uuid)	Το αναγνωριστικό GraphModel.
workspaceId	path	True	string (uuid)	Το αναγνωριστικό χώρου εργασίας.
beta	query	True	boolean	Αυτή η απαιτούμενη παράμετρος πρέπει να οριστεί για `true` πρόσβαση σε αυτό το API, το οποίο βρίσκεται αυτήν τη στιγμή σε beta.

Αποκρίσεις

Ονομασία Τύπος Περιγραφή

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	Ένας τύπος άκρου γραφήματος.
ErrorParameter	Μια δομημένη παράμετρος που παρέχει πρόσθετο περιβάλλον αναγνώσιμο από υπολογιστή σχετικά με ένα σφάλμα.
ErrorRelatedResource	Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.
ErrorResponse	Η απόκριση σφάλματος.
ErrorResponseDetails	Οι λεπτομέρειες της απόκρισης σφάλματος.
GraphType	Ο τύπος γραφήματος που καθορίζει τη δομή ενός γραφήματος.
NodeType	Ένας τύπος κόμβου γραφήματος.
NodeTypeReference	Μια αναφορά σε έναν τύπο κόμβου.
Property	Μια ιδιότητα στοιχείου γραφήματος.

EdgeType

Αντικείμενο

Ένας τύπος άκρου γραφήματος.

Ονομασία	Τύπος	Περιγραφή
alias	string	Το ψευδώνυμο τύπου άκρου.
destinationNodeType	NodeTypeReference	Ο τύπος κόμβου προορισμού.
labels	string[]	Οι ετικέτες τύπου άκρου.
properties	Property[]	Μια λίστα ιδιοτήτων τύπου άκρου.
sourceNodeType	NodeTypeReference	Ο τύπος κόμβου προέλευσης.

ErrorParameter

Αντικείμενο

Μια δομημένη παράμετρος που παρέχει πρόσθετο περιβάλλον αναγνώσιμο από υπολογιστή σχετικά με ένα σφάλμα.

Ονομασία	Τύπος	Περιγραφή
message	string	Μια αναγνώσιμη από τον άνθρωπο περιγραφή της έννοιας της παραμέτρου.
name	string	Το αναγνωριστικό παραμέτρου.
value	string	Η τιμή της παραμέτρου.

ErrorRelatedResource

Αντικείμενο

Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.

Ονομασία	Τύπος	Περιγραφή
resourceId	string	Το αναγνωριστικό πόρου που εμπλέκεται στο σφάλμα.
resourceType	string	Ο τύπος του πόρου που εμπλέκεται στο σφάλμα.

ErrorResponse

Αντικείμενο

Η απόκριση σφάλματος.

Ονομασία	Τύπος	Περιγραφή
errorCode	string	Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της.
isRetriable	boolean	Όταν είναι true, η αίτηση μπορεί να επαναληφθεί. Χρησιμοποιήστε την `Retry-After` κεφαλίδα απόκρισης για να προσδιορίσετε την καθυστέρηση, εάν υπάρχει.
message	string	Μια αναγνώσιμη αναπαράσταση του σφάλματος.
moreDetails	ErrorResponseDetails[]	Λίστα πρόσθετων λεπτομερειών σφάλματος.
parameters	ErrorParameter[]	Δομημένες παράμετροι που παρέχουν πρόσθετο περιβάλλον αναγνώσιμο από υπολογιστή σχετικά με το σφάλμα.
relatedResource	ErrorRelatedResource	Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.
requestId	string (uuid)	Το αναγνωριστικό της αίτησης που σχετίζεται με το σφάλμα.

ErrorResponseDetails

Αντικείμενο

Οι λεπτομέρειες της απόκρισης σφάλματος.

Ονομασία	Τύπος	Περιγραφή
errorCode	string	Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της.
message	string	Μια αναγνώσιμη αναπαράσταση του σφάλματος.
parameters	ErrorParameter[]	Δομημένες παράμετροι που παρέχουν πρόσθετο περιβάλλον αναγνώσιμο από υπολογιστή σχετικά με το σφάλμα.
relatedResource	ErrorRelatedResource	Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.

GraphType

Αντικείμενο

Ο τύπος γραφήματος που καθορίζει τη δομή ενός γραφήματος.

Ονομασία	Τύπος	Περιγραφή
edgeTypes	EdgeType[]	Μια λίστα με τύπους άκρου γραφήματος.
nodeTypes	NodeType[]	Μια λίστα τύπων κόμβου γραφήματος.

NodeType

Αντικείμενο

Ένας τύπος κόμβου γραφήματος.

Ονομασία	Τύπος	Περιγραφή
alias	string	Το ψευδώνυμο τύπου κόμβου.
labels	string[]	Οι ετικέτες τύπου κόμβου.
primaryKeyProperties	string[]	Μια λίστα ιδιοτήτων πρωτεύοντος κλειδιού τύπου κόμβου.
properties	Property[]	Μια λίστα ιδιοτήτων τύπου κόμβου.

NodeTypeReference

Αντικείμενο

Μια αναφορά σε έναν τύπο κόμβου.

Ονομασία	Τύπος	Περιγραφή
alias	string	Το ψευδώνυμο τύπου κόμβου.

Property

Αντικείμενο

Μια ιδιότητα στοιχείου γραφήματος.

Ονομασία	Τύπος	Περιγραφή
name	string	Το όνομα ιδιότητας.
type	string	Ο τύπος ιδιότητας.