Items - Refresh Sql Endpoint Metadata

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

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

Όταν tables παρέχεται στο σώμα αίτησης, ανανεώνονται μόνο οι καθορισμένοι πίνακες. Όταν παραλειφθεί ή είναι κενό, όλοι οι πίνακες ανανεώνονται.

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 κατά τη διαδικασία ανανέωσης. Χρησιμοποιήστε αυτή την επιλογή εάν θέλετε να δημιουργήσετε πλήρως πίνακες από τους ορισμούς προέλευσής τους, για παράδειγμα, για να επιλύσετε ασυνέπειες ή να εξασφαλίσετε μια καθαρή ανανέωση. Όταν συνδυάζεται με tablesτο , η επαναφορά κατάστασης συγχρονισμού περικλείεται μόνο στους καθορισμένους πίνακες. Η προεπιλεγμένη τιμή είναι false.
tables

TableDefinition[]

Όταν παρέχεται, η εμβέλεια της ανανέωσης εφαρμόζεται μόνο στους πίνακες που παρατίθενται. Όταν παραλειφθεί ή είναι κενό, όλοι οι πίνακες ανανεώνονται. Κάθε καταχώρηση καθορίζει ένα σχήμα και ένα ή περισσότερα ονόματα πινάκων για ανανέωση σε αυτό το σχήμα. Ο μέγιστος αριθμός πινάκων που μπορούν να συγχρονιστούν σε μία αίτηση είναι 25. Η ανάλυση πίνακα εξαρτάται από το εάν το γονικό στοιχείο του τελικού σημείου SQL έχει δυνατότητα σχήματος. Για στοιχεία με δυνατότητα σχήματος, οι πίνακες επιλύονται χρησιμοποιώντας το σχήμα που παρέχεται από τον καλούντα. Για στοιχεία χωρίς δυνατότητα σχήματος, όλοι οι πίνακες επιλύονται κάτω από το προεπιλεγμένο σχήμα, ανεξάρτητα από την τιμή σχήματος που παρέχεται από τον καλούντα. Οι πίνακες κάτω από ένα μη προεπιλεγμένο σχήμα δεν μπορούν να επιλυθούν και θα αναφέρονται με σφάλμα DeltaTableNotFound .
timeout

Duration

Η διάρκεια αίτησης πριν από τη λήξη του χρονικού ωρών. Η προεπιλεγμένη τιμή είναι 15 λεπτά.

Αποκρίσεις

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

TableSyncStatuses

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

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

Κεφαλίδες

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
429 Too Many Requests

ErrorResponse

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

Κεφαλίδες

Retry-After: integer
Other Status Codes

ErrorResponse

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

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

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

Refresh all tables for a specified SQL analytics endpoint in a workspace
Refresh selective tables for a specified SQL analytics endpoint in a workspace
Refresh selective tables with recreate tables for a specified SQL analytics endpoint in a workspace
Refresh selective tables with user defined schemas for a specified SQL analytics endpoint in a workspace

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

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

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"
    }
  ]
}

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

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

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

{
  "tables": [
    {
      "schema": "dbo",
      "tableNames": [
        "Orders",
        "OrderDetails"
      ]
    },
    {
      "schema": "dbo",
      "tableNames": [
        "DailySummary"
      ]
    }
  ]
}

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

Κωδικός κατάστασης:
200 
{
  "value": [
    {
      "tableName": "Orders",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:25.9651741Z",
      "status": "Success",
      "lastSuccessfulSyncDateTime": "2026-06-09T14:31:25.9651741Z"
    },
    {
      "tableName": "OrderDetails",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:26.5329616Z",
      "status": "Failure",
      "error": {
        "errorCode": "DeltaTableNotFound",
        "message": "Delta table 'Tables\\OrderDetails\\_delta_log' not found."
      },
      "lastSuccessfulSyncDateTime": "2026-06-08T10:31:26.5329616Z"
    },
    {
      "tableName": "DailySummary",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:24.9183509Z",
      "status": "NotRun",
      "lastSuccessfulSyncDateTime": "2026-06-08T08:32:53.3890146Z"
    }
  ]
}

Refresh selective tables with recreate tables for a specified SQL analytics endpoint in a workspace

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

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

{
  "recreateTables": true,
  "tables": [
    {
      "schema": "dbo",
      "tableNames": [
        "Orders",
        "OrderDetails"
      ]
    }
  ]
}

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

Κωδικός κατάστασης:
200 
{
  "value": [
    {
      "tableName": "Orders",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:25.9651741Z",
      "status": "Success",
      "lastSuccessfulSyncDateTime": "2026-06-09T14:31:25.9651741Z"
    },
    {
      "tableName": "OrderDetails",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:26.5329616Z",
      "status": "Success",
      "lastSuccessfulSyncDateTime": "2026-06-09T14:31:26.5329616Z"
    }
  ]
}

Refresh selective tables with user defined schemas for a specified SQL analytics endpoint in a workspace

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

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

{
  "tables": [
    {
      "schema": "sales",
      "tableNames": [
        "Orders",
        "OrderDetails"
      ]
    },
    {
      "schema": "analytics",
      "tableNames": [
        "DailySummary"
      ]
    }
  ]
}

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

Κωδικός κατάστασης:
200 
{
  "value": [
    {
      "tableName": "sales.Orders",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:25.9651741Z",
      "status": "Success",
      "lastSuccessfulSyncDateTime": "2026-06-09T14:31:25.9651741Z"
    },
    {
      "tableName": "sales.OrderDetails",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:26.5329616Z",
      "status": "Success",
      "lastSuccessfulSyncDateTime": "2026-06-09T14:31:26.5329616Z"
    },
    {
      "tableName": "analytics.DailySummary",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:24.9183509Z",
      "status": "Success",
      "lastSuccessfulSyncDateTime": "2026-06-09T14:31:24.9183509Z"
    }
  ]
}

Ορισμοί

Όνομα Περιγραφή
Duration

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

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

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

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

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

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

Ένα ζεύγος ονομάτων σχήματος και πίνακα για την εμβέλεια μιας επιλεκτικής ανανέωσης.
TableSyncStatus

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

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

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

Duration

Αντικείμενο

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

Όνομα Τύπος Περιγραφή
timeUnit

TimeUnit

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

number

Ο αριθμός των χρονικών μονάδων στη διάρκεια.

ErrorRelatedResource

Αντικείμενο

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

Όνομα Τύπος Περιγραφή
resourceId

string

Το αναγνωριστικό πόρου που εμπλέκεται στο σφάλμα.
resourceType

string

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

ErrorResponse

Αντικείμενο

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

Όνομα Τύπος Περιγραφή
errorCode

string

Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της.
isRetriable

boolean

Όταν είναι true, η αίτηση μπορεί να επαναληφθεί. Χρησιμοποιήστε την Retry-After κεφαλίδα απόκρισης για να προσδιορίσετε την καθυστέρηση, εάν υπάρχει.
message

string

Μια αναγνώσιμη αναπαράσταση του σφάλματος.
moreDetails

ErrorResponseDetails[]

Λίστα πρόσθετων λεπτομερειών σφάλματος.
relatedResource

ErrorRelatedResource

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

string (uuid)

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

ErrorResponseDetails

Αντικείμενο

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

Όνομα Τύπος Περιγραφή
errorCode

string

Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της.
message

string

Μια αναγνώσιμη αναπαράσταση του σφάλματος.
relatedResource

ErrorRelatedResource

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

SqlEndpointRefreshMetadataRequest

Αντικείμενο

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

Όνομα Τύπος Περιγραφή
recreateTables

boolean

Όταν οριστεί σε true, αυτή η ιδιότητα δίνει εντολή στο σύστημα να αποθέσει και να δημιουργήσει εκ νέου όλους τους πίνακες στο τελικό σημείο ανάλυσης SQL κατά τη διαδικασία ανανέωσης. Χρησιμοποιήστε αυτή την επιλογή εάν θέλετε να δημιουργήσετε πλήρως πίνακες από τους ορισμούς προέλευσής τους, για παράδειγμα, για να επιλύσετε ασυνέπειες ή να εξασφαλίσετε μια καθαρή ανανέωση. Όταν συνδυάζεται με tablesτο , η επαναφορά κατάστασης συγχρονισμού περικλείεται μόνο στους καθορισμένους πίνακες. Η προεπιλεγμένη τιμή είναι false.
tables

TableDefinition[]

Όταν παρέχεται, η εμβέλεια της ανανέωσης εφαρμόζεται μόνο στους πίνακες που παρατίθενται. Όταν παραλειφθεί ή είναι κενό, όλοι οι πίνακες ανανεώνονται. Κάθε καταχώρηση καθορίζει ένα σχήμα και ένα ή περισσότερα ονόματα πινάκων για ανανέωση σε αυτό το σχήμα. Ο μέγιστος αριθμός πινάκων που μπορούν να συγχρονιστούν σε μία αίτηση είναι 25. Η ανάλυση πίνακα εξαρτάται από το εάν το γονικό στοιχείο του τελικού σημείου SQL έχει δυνατότητα σχήματος. Για στοιχεία με δυνατότητα σχήματος, οι πίνακες επιλύονται χρησιμοποιώντας το σχήμα που παρέχεται από τον καλούντα. Για στοιχεία χωρίς δυνατότητα σχήματος, όλοι οι πίνακες επιλύονται κάτω από το προεπιλεγμένο σχήμα, ανεξάρτητα από την τιμή σχήματος που παρέχεται από τον καλούντα. Οι πίνακες κάτω από ένα μη προεπιλεγμένο σχήμα δεν μπορούν να επιλυθούν και θα αναφέρονται με σφάλμα DeltaTableNotFound .
timeout

Duration

Η διάρκεια αίτησης πριν από τη λήξη του χρονικού ωρών. Η προεπιλεγμένη τιμή είναι 15 λεπτά.

SyncStatus

Απαρίθμηση

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

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

Υποδεικνύει επιτυχία.
Failure

Υποδεικνύει μια αποτυχία.
NotRun

Υποδεικνύει ότι η λειτουργία δεν εκτελέστηκε.

TableDefinition

Αντικείμενο

Ένα ζεύγος ονομάτων σχήματος και πίνακα για την εμβέλεια μιας επιλεκτικής ανανέωσης.

Όνομα Τύπος Περιγραφή
schema

string

minLength: 1
maxLength: 128

Το όνομα σχήματος για την ανάλυση πίνακα. Δεν πρέπει να είναι ένα δεσμευμένο σχήμα συστήματος.
tableNames

string[]

minLength: 1
maxLength: 128

Ένα ή περισσότερα ονόματα πίνακα για ανανέωση κάτω από το καθορισμένο σχήμα.

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

Το όνομα του πίνακα που συγχρονίζεται. Για στοιχεία με δυνατότητα σχήματος, το όνομα του πίνακα έχει πρόθεμα το όνομα σχήματος (π.χ. "schema.tableName").

TableSyncStatuses

Αντικείμενο

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

Όνομα Τύπος Περιγραφή
value

TableSyncStatus[]

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

TimeUnit

Απαρίθμηση

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

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

Διάρκεια σε δευτερόλεπτα.
Minutes

Διάρκεια σε λεπτά.
Hours

Διάρκεια σε ώρες.
Days

Διάρκεια σε ημέρες.