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

Αίτημα δείγματος

HTTP

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 για τον χώρο εργασίας που περιέχει αυτή την αποθήκη.
ErrorRelatedResource	Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.
ErrorResponse	Η απόκριση σφάλματος.
ErrorResponseDetails	Οι λεπτομέρειες της απόκρισης σφάλματος.
PrivateLinkType	Υποδεικνύει τον τύπο ιδιωτικής σύνδεσης που χρησιμοποιεί αυτή η συμβολοσειρά σύνδεσης. Επιπλέον privateLinkType τύποι μπορούν να προστεθούν με την πάροδο του χρόνου.

ConnectionStringResponse

Αντικείμενο

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

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

ErrorRelatedResource

Αντικείμενο

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

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

ErrorResponse

Αντικείμενο

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

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

ErrorResponseDetails

Αντικείμενο

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

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

PrivateLinkType

Απαρίθμηση

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

Τιμή	Περιγραφή
None	Δεν υπάρχει ιδιωτική σύνδεση (προεπιλογή).
Workspace	Ιδιωτική σύνδεση χώρου εργασίας.