Κοινή χρήση μέσω

Topology - Get Eventstream Destination

  • Αναφορά
Υπηρεσία:
Eventstream
Έκδοση API:
v1

Επιστρέφει τον καθορισμένο προορισμό της ροής συμβάντων.

Δικαιώματα

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

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

Eventstream.Read.All ή Eventstream.ReadWrite.All ή Item.Read.All ή Item.ReadWrite.All

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

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

Ταυτότητα Υποστηρίζω
Χρήστης Όχι
Υπηρεσίας και διαχειριζόμενες ταυτότητες Όχι

Διεπαφή

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/eventstreams/{eventstreamId}/destinations/{destinationId}

Παράμετροι URI

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

string (uuid)

Το αναγνωριστικό προορισμού.
eventstreamId
 path True

string (uuid)

Το αναγνωριστικό eventstream.
workspaceId
 path True

string (uuid)

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

Αποκρίσεις

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

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

ErrorResponse

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

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

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

Get an eventstream destination example

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

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/eventstreams/8c500070-073f-4a88-b478-8fabe1941c52/destinations/2e4c91e7-0c4a-4cc4-abe3-cc7ba4310a37

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

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

Ορισμοί

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

Ιδιότητες προορισμού ενεργοποίησης.
ActivatorDestinationResponse

Απόκριση προορισμού ενεργοποίησης.
AvroSerializationInfo

Πληροφορίες σειριοποίησης avro.
AvroSerializationProperties

Ιδιότητες σειριοποίησης Avro.
ColumnSchema

Αντιπροσωπεύει το σχήμα μιας στήλης.
CsvSerializationInfo

Πληροφορίες σειριοποίησης CSV.
CsvSerializationProperties

Ιδιότητες σειριοποίησης CSV.
CustomEndpointDestinationProperties

Ιδιότητες προορισμού προσαρμοσμένων συμβάντων τελικού σημείου.
CustomEndpointDestinationResponse

Απόκριση προορισμού προσαρμοσμένων συμβάντων τελικού σημείου.
DataType

Αντιπροσωπεύει τον τύπο δεδομένων. Επιπλέον τύποι δεδομένων μπορούν να προστεθούν με την πάροδο του χρόνου.
DestinationType

Αντιπροσωπεύει τον τύπο του προορισμού. Μπορούν να προστεθούν πρόσθετοι τύποι προορισμού με την πάροδο του χρόνου.
ErrorInfo

Αντιπροσωπεύει τις πληροφορίες σφάλματος.
ErrorRelatedResource

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

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

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

Απόκριση προορισμού eventhouse.
EventhouseDirectIngestionModeDestinationProperties

Ιδιότητες προορισμού λειτουργίας DirectIngestion eventhouse.
EventhouseProcessedIngestionModeDestinationProperties

Ιδιότητες προορισμού λειτουργίας επεξεργασίας eventhouse.
InputSchema

Αντιπροσωπεύει το σχήμα εισόδου της προέλευσης, προορισμού ή τελεστή.
JsonSerializationInfo

Πληροφορίες σειριοποίησης JSON.
JsonSerializationProperties

Ιδιότητες σειριοποίησης JSON.
LakehouseDestinationProperties

Ιδιότητες προορισμού Lakehouse.
LakehouseDestinationResponse

Απόκριση προορισμού Lakehouse.
NodeReference

Αντιπροσωπεύει μια αναφορά σε έναν κόμβο χρησιμοποιώντας το μοναδικό όνομά του.
NodeStatus

Η κατάσταση του κόμβου. Μπορεί να προστεθεί επιπλέον κατάσταση κόμβου με την πάροδο του χρόνου.
Schema

Αντιπροσωπεύει το σχήμα των δεδομένων.
SerializationType

Ο τύπος σειριοποίησης.

ActivatorDestinationProperties

Object

Ιδιότητες προορισμού ενεργοποίησης.

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

Πληροφορίες σειριοποίησης.
itemId

string (uuid)

Το αναγνωριστικό στοιχείου Ενεργοποίηση.
workspaceId

string (uuid)

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

ActivatorDestinationResponse

Object

Απόκριση προορισμού ενεργοποίησης.

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

ErrorInfo

Οι πληροφορίες σφάλματος.
id

string (uuid)

Το μοναδικό αναγνωριστικό του προορισμού.
inputNodes

NodeReference[]

Μια λίστα με τις αναφορές στους κόμβους εισόδου του προορισμού.
inputSchemas

InputSchema[]

Τα σχήματα εισόδου του προορισμού.
name

string

Το μοναδικό όνομα του προορισμού.
properties

ActivatorDestinationProperties

Οι ιδιότητες του προορισμού Ενεργοποίηση.
status

NodeStatus

Η κατάσταση του κόμβου. Μπορεί να προστεθεί επιπλέον κατάσταση κόμβου με την πάροδο του χρόνου.
type string:

Activator

Ο τύπος του προορισμού.

AvroSerializationInfo

Object

Πληροφορίες σειριοποίησης avro.

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

AvroSerializationProperties

Ιδιότητες σειριοποίησης Avro.
type string:

Avro

Ο τύπος σειριοποίησης.

AvroSerializationProperties

Object

Ιδιότητες σειριοποίησης Avro.

ColumnSchema

Object

Αντιπροσωπεύει το σχήμα μιας στήλης.

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

ColumnSchema[]

Μια λίστα με τα πεδία για τον τύπο δεδομένων εγγραφής ή πίνακα.
items

ColumnSchema

Το σχήμα των στοιχείων πίνακα.
name

string

Το όνομα της στήλης.
type

DataType

Ο τύπος δεδομένων της στήλης.

CsvSerializationInfo

Object

Πληροφορίες σειριοποίησης CSV.

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

CsvSerializationProperties

Ιδιότητες σειριοποίησης CSV.
type string:

Csv

Ο τύπος σειριοποίησης.

CsvSerializationProperties

Object

Ιδιότητες σειριοποίησης CSV.

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

UTF8

Ο τύπος κωδικοποίησης.
fieldDelimiter

string

Ο οριοθέτης πεδίων.
format enum:
  • WithHeaders
  • WithoutHeaders

Ο τύπος μορφής.

CustomEndpointDestinationProperties

Object

Ιδιότητες προορισμού προσαρμοσμένων συμβάντων τελικού σημείου.

CustomEndpointDestinationResponse

Object

Απόκριση προορισμού προσαρμοσμένων συμβάντων τελικού σημείου.

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

ErrorInfo

Οι πληροφορίες σφάλματος.
id

string (uuid)

Το μοναδικό αναγνωριστικό του προορισμού.
inputNodes

NodeReference[]

Μια λίστα με τις αναφορές στους κόμβους εισόδου του προορισμού.
inputSchemas

InputSchema[]

Τα σχήματα εισόδου του προορισμού.
name

string

Το μοναδικό όνομα του προορισμού.
properties

CustomEndpointDestinationProperties

Οι ιδιότητες του προσαρμοσμένου προορισμού τελικού σημείου.
status

NodeStatus

Η κατάσταση του κόμβου. Μπορεί να προστεθεί επιπλέον κατάσταση κόμβου με την πάροδο του χρόνου.
type string:

CustomEndpoint

Ο τύπος του προορισμού.

DataType

Απαρίθμηση

Αντιπροσωπεύει τον τύπο δεδομένων. Επιπλέον τύποι δεδομένων μπορούν να προστεθούν με την πάροδο του χρόνου.

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

Άγνωστος τύπος δεδομένων.
Array

Τύπος δεδομένων πίνακα.
BigInt

Τύπος δεδομένων BigInt.
Bit

Τύπος δεδομένων bit.
DateTime

Τύπος δεδομένων ημερομηνίας/ώρας.
Float

Τύπος δεδομένων κινητής υποδιαστολής.
Nvarchar(max)

Τύπος δεδομένων Nvarchar(μέγιστο).
Record

Εγγραφή τύπου δεδομένων.

DestinationType

Απαρίθμηση

Αντιπροσωπεύει τον τύπο του προορισμού. Μπορούν να προστεθούν πρόσθετοι τύποι προορισμού με την πάροδο του χρόνου.

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

Ο τύπος προορισμού ενεργοποίησης.
CustomEndpoint

Ο τύπος προορισμού CustomEndpoint.
Eventhouse

Ο τύπος προορισμού Eventhouse.
Lakehouse

Ο τύπος προορισμού lakehouse.

ErrorInfo

Object

Αντιπροσωπεύει τις πληροφορίες σφάλματος.

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

string

Ο κωδικός σφάλματος.
errorDetails

string[]

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

string

Το μήνυμα σφάλματος.

ErrorRelatedResource

Object

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

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

string

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

string

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

ErrorResponse

Object

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

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

string

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

string

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

ErrorResponseDetails[]

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

ErrorRelatedResource

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

string

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

ErrorResponseDetails

Object

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

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

string

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

string

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

ErrorRelatedResource

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

EventhouseDestinationResponse

Object

Απόκριση προορισμού eventhouse.

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

ErrorInfo

Οι πληροφορίες σφάλματος.
id

string (uuid)

Το μοναδικό αναγνωριστικό του προορισμού.
inputNodes

NodeReference[]

Μια λίστα με τις αναφορές στους κόμβους εισόδου του προορισμού.
inputSchemas

InputSchema[]

Τα σχήματα εισόδου του προορισμού.
name

string

Το μοναδικό όνομα του προορισμού.
properties EventhouseDestinationProperties:

Ιδιότητες προορισμού eventhouse.
status

NodeStatus

Η κατάσταση του κόμβου. Μπορεί να προστεθεί επιπλέον κατάσταση κόμβου με την πάροδο του χρόνου.
type string:

Eventhouse

Ο τύπος του προορισμού.

EventhouseDirectIngestionModeDestinationProperties

Object

Ιδιότητες προορισμού λειτουργίας DirectIngestion eventhouse.

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

string

Το όνομα της σύνδεσης.
dataIngestionMode string:

DirectIngestion

Η λειτουργία πρόσληψης δεδομένων.
itemId

string (uuid)

Το αναγνωριστικό στοιχείου Eventhouse.
mappingRuleName

string

Το όνομα κανόνα αντιστοίχισης.
tableName

string

Το όνομα του πίνακα KQL.
workspaceId

string (uuid)

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

EventhouseProcessedIngestionModeDestinationProperties

Object

Ιδιότητες προορισμού λειτουργίας επεξεργασίας eventhouse.

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

ProcessedIngestion

Η λειτουργία πρόσληψης δεδομένων.
databaseName

string

Το όνομα της βάσης δεδομένων KQL.
inputSerialization SerializationInfo:

Πληροφορίες σειριοποίησης.
itemId

string (uuid)

Το αναγνωριστικό στοιχείου Eventhouse.
tableName

string

Το όνομα του πίνακα KQL.
workspaceId

string (uuid)

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

InputSchema

Object

Αντιπροσωπεύει το σχήμα εισόδου της προέλευσης, προορισμού ή τελεστή.

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

string

Το όνομα του σχήματος εισόδου.
schema

Schema

Αντιπροσωπεύει το σχήμα των δεδομένων.

JsonSerializationInfo

Object

Πληροφορίες σειριοποίησης JSON.

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

JsonSerializationProperties

Ιδιότητες σειριοποίησης JSON.
type string:

Json

Ο τύπος σειριοποίησης.

JsonSerializationProperties

Object

Ιδιότητες σειριοποίησης JSON.

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

UTF8

Ο τύπος κωδικοποίησης.

LakehouseDestinationProperties

Object

Ιδιότητες προορισμού Lakehouse.

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

string

Το όνομα του πίνακα δέλτα.
inputSerialization SerializationInfo:

Πληροφορίες σειριοποίησης.
itemId

string (uuid)

Το αναγνωριστικό στοιχείου Lakehouse.
maximumDurationInSeconds

integer

120

Η μέγιστη διάρκεια σε δευτερόλεπτα για μια δέσμη εξόδου. Η προεπιλογή είναι 120.
minimumRows

integer

100000

Ο ελάχιστος αριθμός γραμμών για μια δέσμη εξόδου. Η προεπιλογή είναι 100000.
schema

string

Το όνομα σχήματος.
workspaceId

string (uuid)

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

LakehouseDestinationResponse

Object

Απόκριση προορισμού Lakehouse.

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

ErrorInfo

Οι πληροφορίες σφάλματος.
id

string (uuid)

Το μοναδικό αναγνωριστικό του προορισμού.
inputNodes

NodeReference[]

Μια λίστα με τις αναφορές στους κόμβους εισόδου του προορισμού.
inputSchemas

InputSchema[]

Τα σχήματα εισόδου του προορισμού.
name

string

Το μοναδικό όνομα του προορισμού.
properties

LakehouseDestinationProperties

Οι ιδιότητες του προορισμού Lakehouse.
status

NodeStatus

Η κατάσταση του κόμβου. Μπορεί να προστεθεί επιπλέον κατάσταση κόμβου με την πάροδο του χρόνου.
type string:

Lakehouse

Ο τύπος του προορισμού.

NodeReference

Object

Αντιπροσωπεύει μια αναφορά σε έναν κόμβο χρησιμοποιώντας το μοναδικό όνομά του.

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

string

Το μοναδικό όνομα του κόμβου.

NodeStatus

Απαρίθμηση

Η κατάσταση του κόμβου. Μπορεί να προστεθεί επιπλέον κατάσταση κόμβου με την πάροδο του χρόνου.

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

Ο κόμβος δημιουργήθηκε.
Creating

Δημιουργείται ο κόμβος.
Deleting

Ο κόμβος διαγράφεται.
External

Η κατάσταση του κόμβου εξαρτάται από μια εξωτερική υπηρεσία.
Failed

Ο κόμβος απέτυχε.
Paused

Ο κόμβος διακόπτεται.
Pausing

Γίνεται παύση του κόμβου.
Resuming

Ο κόμβος συνεχίζει.
Running

Ο κόμβος είναι σε λειτουργία.
Unknown

Η κατάσταση του κόμβου είναι άγνωστη.
Updating

Ο κόμβος ενημερώνεται.
Warning

Ο κόμβος έχει μια προειδοποίηση.

Schema

Object

Αντιπροσωπεύει το σχήμα των δεδομένων.

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

ColumnSchema[]

Μια λίστα με τις στήλες στο σχήμα.

SerializationType

Απαρίθμηση

Ο τύπος σειριοποίησης.

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

Ο τύπος σειριοποίησης είναι Avro.
Csv

Ο τύπος σειριοποίησης είναι CSV.
Json

Ο τύπος σειριοποίησης είναι JSON.