Items - Get Connection String

Υπηρεσία:
Warehouse
Έκδοση API:
v1

Επιστρέφει τη συμβολοσειρά σύνδεσης SQL της καθορισμένης αποθήκης.

Δικαιώματα

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

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

Warehouse.Read.All ή Warehouse.ReadWrite.All ή Item.Read.All ή Item.ReadWrite.All

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

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

Ταυτότητα Υποστηρίζω
Χρήστης Ναι
Κύρια υπηρεσία και Διαχειριζόμενες ταυτότητες Ναι

Διεπαφή

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/warehouses/{warehouseId}/connectionString
Με προαιρετικές παραμέτρους: 
GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/warehouses/{warehouseId}/connectionString?guestTenantId={guestTenantId}&privateLinkType={privateLinkType}

Παράμετροι URI

Ονομασία Σε Απαιτείται Τύπος Περιγραφή
warehouseId
 path True

string (uuid)

Το αναγνωριστικό αποθήκης.
workspaceId
 path True

string (uuid)

Το αναγνωριστικό χώρου εργασίας.
guestTenantId
 query

string (uuid)

Το αναγνωριστικό μισθωτή επισκέπτη εάν ο μισθωτής του τελικού χρήστη είναι διαφορετικός από τον μισθωτή της αποθήκης.
privateLinkType
 query

PrivateLinkType

Υποδεικνύει τον τύπο ιδιωτικής σύνδεσης που χρησιμοποιεί αυτή η συμβολοσειρά σύνδεσης. Επιπλέον privateLinkType τύποι μπορούν να προστεθούν με την πάροδο του χρόνου.

Αποκρίσεις

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

ConnectionStringResponse

Η αίτηση ολοκληρώθηκε με επιτυχία.
429 Too Many Requests

ErrorResponse

Έγινε υπέρβαση του ορίου επιτοκίου υπηρεσίας. Ο διακομιστής επιστρέφει μια Retry-After κεφαλίδα που υποδεικνύει, σε δευτερόλεπτα, πόσο πρέπει να περιμένει ο υπολογιστής-πελάτης πριν από την αποστολή πρόσθετων αιτήσεων.

Κεφαλίδες

Retry-After: integer
Other Status Codes

ErrorResponse

Συνήθεις κωδικοί σφαλμάτων:

  • ItemNotFound - Το στοιχείο που ζητήθηκε δεν βρέθηκε.

  • InvalidGuestTenantId - Το παρεχόμενο αναγνωριστικό μισθωτή επισκέπτη δεν υπάρχει.

Παραδείγματα

Get connection string example

Δείγμα αίτησης

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/warehouses/5b218778-e7a5-4d73-8187-f10824047715/connectionString?guestTenantId=6e335e92-a2a2-4b5a-970a-bd6a89fbb765

Δείγμα απόκρισης

Κωδικός κατάστασης:
200 
{
  "connectionString": "qvrmbuxie7we7glrekxgy6npqu-6xgyei3x2xiejip4iime6knh5m-jh0bi.zcf.datawarehouse.fabric.microsoft.com"
}

Ορισμοί

Ονομασία Περιγραφή
ConnectionStringResponse

Η συμβολοσειρά σύνδεσης SQL για τον χώρο εργασίας που περιέχει αυτή την αποθήκη.
ErrorParameter

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

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

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

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

Υποδεικνύει τον τύπο ιδιωτικής σύνδεσης που χρησιμοποιεί αυτή η συμβολοσειρά σύνδεσης. Επιπλέον privateLinkType τύποι μπορούν να προστεθούν με την πάροδο του χρόνου.

ConnectionStringResponse

Αντικείμενο

Η συμβολοσειρά σύνδεσης SQL για τον χώρο εργασίας που περιέχει αυτή την αποθήκη.

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

string

Η συμβολοσειρά σύνδεσης SQL για τον χώρο εργασίας που περιέχει αυτή την αποθήκη.

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

Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.

PrivateLinkType

Απαρίθμηση

Υποδεικνύει τον τύπο ιδιωτικής σύνδεσης που χρησιμοποιεί αυτή η συμβολοσειρά σύνδεσης. Επιπλέον privateLinkType τύποι μπορούν να προστεθούν με την πάροδο του χρόνου.

Τιμή Περιγραφή
None

Δεν υπάρχει ιδιωτική σύνδεση (προεπιλογή).
Workspace

Ιδιωτική σύνδεση χώρου εργασίας.