Items - Refresh Sql Endpoint Metadata

Υπηρεσία:: SQLEndpoint

Έκδοση API:: v1

Ανανεώνει όλους τους πίνακες σε ένα τελικό σημείο ανάλυσης SQL.
Αυτό το API υποστηρίζει λειτουργίες μεγάλης διάρκειας (LRO).

Permissions

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

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

Item.ReadWrite.All

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

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

Identity	Support
User	Yes
Υπηρεσίας και διαχειριζόμενες ταυτότητες	Yes

Interface

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/sqlEndpoints/{sqlEndpointId}/refreshMetadata

Παράμετροι URI

Όνομα	Μέσα	Απαιτούμενο	Δακτυλογραφώ	Περιγραφή
sqlEndpointId	path	True	string (uuid)	Το αναγνωριστικό τελικού σημείου ανάλυσης SQL.
workspaceId	path	True	string (uuid)	Το αναγνωριστικό χώρου εργασίας.

Σώμα αιτήματος

Όνομα	Δακτυλογραφώ	Περιγραφή
recreateTables	boolean	Όταν οριστεί σε true, αυτή η ιδιότητα δίνει εντολή στο σύστημα να αποθέσει και να δημιουργήσει εκ νέου όλους τους πίνακες στο τελικό σημείο της ανάλυσης SQL κατά τη διαδικασία ανανέωσης. Χρησιμοποιήστε αυτή την επιλογή εάν θέλετε να δημιουργήσετε πλήρως πίνακες από τους ορισμούς προέλευσής τους, για παράδειγμα, για να επιλύσετε ασυνέπειες ή να εξασφαλίσετε μια καθαρή ανανέωση. Η προεπιλεγμένη τιμή είναι false.
timeout	Duration	Η διάρκεια αίτησης πριν από τη λήξη του χρονικού ωρών. Η προεπιλεγμένη τιμή είναι 15 λεπτά.

Απαντήσεις

Όνομα	Δακτυλογραφώ	Περιγραφή
200 OK	TableSyncStatuses	Η αίτηση ολοκληρώθηκε με επιτυχία.
202 Accepted		Η αίτηση έγινε αποδεκτή, η ανανέωση πίνακα ανάλυσης SQL βρίσκεται σε εξέλιξη. Κεφαλίδες Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Συνήθεις κωδικοί σφαλμάτων: ItemNotFound - Το στοιχείο που ζητήθηκε δεν βρέθηκε.

Όνομα

Δακτυλογραφώ

Περιγραφή

200 OK

TableSyncStatuses

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

202 Accepted

Η αίτηση έγινε αποδεκτή, η ανανέωση πίνακα ανάλυσης SQL βρίσκεται σε εξέλιξη.

Κεφαλίδες

Location: string
x-ms-operation-id: string
Retry-After: integer

Other Status Codes

ErrorResponse

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

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

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

Refresh all tables for a specified SQL analytics endpoint in a workspace

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

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/sqlEndpoints/5b218778-e7a5-4d73-8187-f10824047715/refreshMetadata

Δείγμα απάντησης

Κωδικός κατάστασης:: 200

{
  "value": [
    {
      "tableName": "Table 1",
      "startDateTime": "2025-08-08T10:31:22.2708973Z",
      "endDateTime": "2025-08-08T10:36:54.9651741Z",
      "status": "Success",
      "lastSuccessfulSyncDateTime": "2025-08-08T10:36:54.9651741Z"
    },
    {
      "tableName": "Table 2",
      "startDateTime": "2025-08-08T10:31:22.2708973Z",
      "endDateTime": "2025-08-08T10:43:02.5329616Z",
      "status": "Failure",
      "error": {
        "errorCode": "AdalRetryException",
        "message": "Couldn't run query. There is a problem with the Microsoft Entra ID token. Have the warehouse owner log in again. If they're unavailable, use the takeover feature."
      },
      "lastSuccessfulSyncDateTime": "2025-08-07T10:44:27.2632648Z"
    },
    {
      "tableName": "Table 3",
      "startDateTime": "2025-08-08T10:31:22.2708973Z",
      "endDateTime": "2025-08-08T10:36:59.9183509Z",
      "status": "NotRun",
      "lastSuccessfulSyncDateTime": "2025-08-06T08:32:53.3890146Z"
    }
  ]
}

Ορισμοί

Όνομα	Περιγραφή
Duration	Μια διάρκεια.
ErrorRelatedResource	Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.
ErrorResponse	Η απόκριση σφάλματος.
ErrorResponseDetails	Οι λεπτομέρειες της απόκρισης σφάλματος.
SqlEndpointRefreshMetadataRequest	Ανανέωση ωφέλιμου φορτίου αίτησης τελικού σημείου ανάλυσης SQL.
SyncStatus	Η κατάσταση της λειτουργίας συγχρονισμού. Πρόσθετοι τύποι SyncStatus μπορούν να προστεθούν με την πάροδο του χρόνου.
TableSyncStatus	Ένα αντικείμενο κατάστασης συγχρονισμού πίνακα.
TableSyncStatuses	Μια λίστα με τις καταστάσεις συγχρονισμού πίνακα.
TimeUnit	Η μονάδα χρόνου για τη διάρκεια. Μπορούν να προστεθούν πρόσθετοι τύποι διάρκειας με την πάροδο του χρόνου.

Duration

Αντικείμενο

Μια διάρκεια.

Όνομα	Δακτυλογραφώ	Περιγραφή
timeUnit	TimeUnit	Η μονάδα χρόνου για τη διάρκεια. Μπορούν να προστεθούν πρόσθετοι τύποι διάρκειας με την πάροδο του χρόνου.
value	number	Ο αριθμός των χρονικών μονάδων στη διάρκεια.

ErrorRelatedResource

Αντικείμενο

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

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

ErrorResponse

Αντικείμενο

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

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

ErrorResponseDetails

Αντικείμενο

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

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

SqlEndpointRefreshMetadataRequest

Αντικείμενο

Ανανέωση ωφέλιμου φορτίου αίτησης τελικού σημείου ανάλυσης SQL.

Όνομα	Δακτυλογραφώ	Περιγραφή
recreateTables	boolean	Όταν οριστεί σε true, αυτή η ιδιότητα δίνει εντολή στο σύστημα να αποθέσει και να δημιουργήσει εκ νέου όλους τους πίνακες στο τελικό σημείο της ανάλυσης SQL κατά τη διαδικασία ανανέωσης. Χρησιμοποιήστε αυτή την επιλογή εάν θέλετε να δημιουργήσετε πλήρως πίνακες από τους ορισμούς προέλευσής τους, για παράδειγμα, για να επιλύσετε ασυνέπειες ή να εξασφαλίσετε μια καθαρή ανανέωση. Η προεπιλεγμένη τιμή είναι false.
timeout	Duration	Η διάρκεια αίτησης πριν από τη λήξη του χρονικού ωρών. Η προεπιλεγμένη τιμή είναι 15 λεπτά.

SyncStatus

Απαρίθμηση

Η κατάσταση της λειτουργίας συγχρονισμού. Πρόσθετοι τύποι SyncStatus μπορούν να προστεθούν με την πάροδο του χρόνου.

Τιμή	Περιγραφή
Success	Υποδεικνύει επιτυχία.
Failure	Υποδεικνύει μια αποτυχία.
NotRun	Υποδεικνύει ότι η λειτουργία δεν εκτελέστηκε.

TableSyncStatus

Αντικείμενο

Ένα αντικείμενο κατάστασης συγχρονισμού πίνακα.

Όνομα	Δακτυλογραφώ	Περιγραφή
endDateTime	string (date-time)	Η ημερομηνία και η ώρα κατά την οποία ολοκληρώθηκε ο συγχρονισμός πίνακα σε μορφή UTC, χρησιμοποιώντας τη μορφή ΕΕΕΕ-ΜΜ-DDTHH:mm:ssZ.
error	ErrorResponseDetails	Οι λεπτομέρειες της απόκρισης σφάλματος
lastSuccessfulSyncDateTime	string (date-time)	Η ημερομηνία και η ώρα που ο συγχρονισμός πίνακα ήταν επιτυχής σε μορφή UTC, χρησιμοποιώντας τη μορφή ΕΕΕΕ-ΜΜ-DDTHH:mm:ssZ.
startDateTime	string (date-time)	Η ημερομηνία και η ώρα που ξεκίνησε ο συγχρονισμός πίνακα σε μορφή UTC, χρησιμοποιώντας τη μορφή ΕΕΕΕ-ΜΜ-ΗΗH:λλ:ssZ.
status	SyncStatus	Εάν ο πίνακας συγχρονίζεται χωρίς σφάλματα.
tableName	string	Το όνομα του πίνακα που συγχρονίζεται.

TableSyncStatuses

Αντικείμενο

Μια λίστα με τις καταστάσεις συγχρονισμού πίνακα.

Όνομα	Δακτυλογραφώ	Περιγραφή
value	TableSyncStatus[]	Μια λίστα με τις καταστάσεις συγχρονισμού πίνακα.

TimeUnit

Απαρίθμηση

Η μονάδα χρόνου για τη διάρκεια. Μπορούν να προστεθούν πρόσθετοι τύποι διάρκειας με την πάροδο του χρόνου.

Τιμή	Περιγραφή
Seconds	Διάρκεια σε δευτερόλεπτα.
Minutes	Διάρκεια σε λεπτά.
Hours	Διάρκεια σε ώρες.
Days	Διάρκεια σε ημέρες.

Κοινοποίηση μέσω

Items - Refresh Sql Endpoint Metadata

Permissions

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

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

Interface

Παράμετροι URI

Σώμα αιτήματος

Απαντήσεις

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

Refresh all tables for a specified SQL analytics endpoint in a workspace

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

Δείγμα απάντησης

Ορισμοί

Duration

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

SqlEndpointRefreshMetadataRequest

SyncStatus

TableSyncStatus

TableSyncStatuses

TimeUnit