Published - Get Datasource

Servizio:: DataAgent

Versione API:: v1

Restituisce i metadati per un'origine dati pubblicata specifica dell'oggetto DataAgent specificato.

Note

La gestione della configurazione dell'agente dati è attualmente disponibile in anteprima (altre informazioni).

Autorizzazioni

Il chiamante deve disporre delle autorizzazioni di lettura per DataAgent.

Ambiti delegati obbligatori

Item.Read.All o Item.ReadWrite.All o DataAgent.Read.All o DataAgent.ReadWrite.All

Identità supportate da Microsoft Entra

Questa API supporta le identità di Microsoft elencate in questa sezione.

Identità	Support
User	Yes
Principale del servizio e Identità gestite	Yes

Interfaccia

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/dataAgents/{dataAgentId}/datasources/{datasourceId}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
dataAgentId	path	True	string (uuid)	ID DataAgent.
datasourceId	path	True	string (uuid)	ID origine dati.
workspaceId	path	True	string (uuid)	L’ID dell’area di lavoro.

Risposte

Nome Tipo Descrizione

200 OK

Nome	Tipo	Descrizione
200 OK	DataAgentDatasourceResponse: FabricItemDatasource LakehouseTablesDatasource	Richiesta completata correttamente.
429 Too Many Requests	ErrorResponse	È stato superato il limite di velocità del servizio. Il server restituisce un'intestazione `Retry-After` che indica, in secondi, per quanto tempo il client deve attendere prima di inviare richieste aggiuntive. Intestazioni Retry-After: integer
Other Status Codes	ErrorResponse	Codici di errore comuni: ItemNotFound: l'elemento richiesto non è stato trovato.

DataAgentDatasourceResponse:

FabricItemDatasource
LakehouseTablesDatasource

Richiesta completata correttamente.

429 Too Many Requests

ErrorResponse

È stato superato il limite di velocità del servizio. Il server restituisce un'intestazione Retry-After che indica, in secondi, per quanto tempo il client deve attendere prima di inviare richieste aggiuntive.

Intestazioni

Retry-After: integer

Other Status Codes

ErrorResponse

Codici di errore comuni:

ItemNotFound: l'elemento richiesto non è stato trovato.

Esempio

Get published DataAgent datasource example

Esempio di richiesta

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/dataAgents/41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87/datasources/70f9282b-1b64-4f08-9e4e-2ab9f0e20e01

Risposta di esempio

Codice di stato:: 200

{
  "id": "70f9282b-1b64-4f08-9e4e-2ab9f0e20e01",
  "instructions": "Use this for document retrieval queries.",
  "type": "FabricItem",
  "displayName": "SalesWarehouse",
  "description": "Sales data warehouse with order and customer information.",
  "itemReference": {
    "referenceType": "ById",
    "itemId": "01234372-7fd9-44d3-bd75-a2718645a82a",
    "workspaceId": "abdd0d48-2eed-4066-adc4-321a9f6a628e"
  },
  "fabricItemType": "Warehouse"
}

Definizioni

Nome	Descrizione
DataAgentSupportedItemType	Tipo di elemento Fabric supportato per un'origine `FabricItem` dati. I valori usano nomi di elementi Fabric pubblicati. È possibile aggiungere altri tipi DataAgentSupportedItemType nel tempo.
DatasourceType	Il tipo di fonte dati. È possibile aggiungere altri tipi DatasourceType nel corso del tempo.
ErrorRelatedResource	Oggetto dei dettagli della risorsa relativo all'errore.
ErrorResponse	Risposta di errore.
ErrorResponseDetails	Dettagli della risposta di errore.
FabricItemDatasource	Un'origine dati DataAgent supportata da un elemento Fabric.
ItemReferenceById	Riferimento di un elemento in base all'oggetto ID.
ItemReferenceByVariable	Riferimento di un elemento per variabile.
ItemReferenceType	Tipo di riferimento dell'elemento. È possibile aggiungere altri tipi di `ItemReferenceType` nel tempo.
LakehouseTablesDatasource	Un'origine dati DataAgent che usa una lakehouse in modalità solo tabelle.

DataAgentSupportedItemType

Enumerazione

Tipo di elemento Fabric supportato per un'origine FabricItem dati. I valori usano nomi di elementi Fabric pubblicati. È possibile aggiungere altri tipi DataAgentSupportedItemType nel tempo.

Valore	Descrizione
Report	Report di Power BI.
SemanticModel	Power BI modello semantico.
Lakehouse	Un lakehouse.
KQLDatabase	Un database KQL.
Warehouse	Un magazzino.
MirroredDatabase	Database con mirroring.
MirroredAzureDatabricksCatalog	Catalogo di Azure Databricks con mirroring.
GraphModel	Modello a grafo.
SQLDatabase	Un database SQL.
Ontology	Ontologia.

DatasourceType

Enumerazione

Il tipo di fonte dati. È possibile aggiungere altri tipi DatasourceType nel corso del tempo.

Valore	Descrizione
FabricItem	Origine dati supportata da un elemento Fabric supportato.
LakehouseTables	Origine dati supportata da un lakehouse in modalità solo tabelle.

ErrorRelatedResource

Oggetto

Oggetto dei dettagli della risorsa relativo all'errore.

Nome	Tipo	Descrizione
resourceId	string	ID risorsa coinvolto nell'errore.
resourceType	string	Tipo della risorsa coinvolta nell'errore.

ErrorResponse

Oggetto

Risposta di errore.

Nome	Tipo	Descrizione
errorCode	string	Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
isRetriable	boolean	Se true, la richiesta può essere ritentata. Usare l'intestazione della `Retry-After` risposta per determinare il ritardo, se disponibile.
message	string	Rappresentazione leggibile dell'errore.
moreDetails	ErrorResponseDetails[]	Elenco di dettagli aggiuntivi sull'errore.
relatedResource	ErrorRelatedResource	Dettagli della risorsa correlati all'errore.
requestId	string (uuid)	ID della richiesta associata all'errore.

ErrorResponseDetails

Oggetto

Dettagli della risposta di errore.

Nome	Tipo	Descrizione
errorCode	string	Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message	string	Rappresentazione leggibile dell'errore.
relatedResource	ErrorRelatedResource	Dettagli della risorsa correlati all'errore.

FabricItemDatasource

Oggetto

Un'origine dati DataAgent supportata da un elemento Fabric.

Nome	Tipo	Descrizione
description	string	Descrizione dell'origine dati.
displayName	string	Nome visualizzato dell'origine dati.
fabricItemType	DataAgentSupportedItemType	Tipo di elemento Fabric dell'origine dati.
id	string (uuid)	ID origine dati.
instructions	string	Istruzioni di intelligenza artificiale personalizzate specifiche per questa origine dati.
itemReference	ItemReference: ItemReferenceById ItemReferenceByVariable	Oggetto di riferimento dell'elemento.
type	string: FabricItem	Il tipo di fonte dati.

ItemReferenceById

Oggetto

Riferimento di un elemento in base all'oggetto ID.

Nome	Tipo	Descrizione
itemId	string (uuid)	ID dell'elemento.
referenceType	string: ById	Tipo di riferimento dell'elemento.
workspaceId	string (uuid)	ID dell'area di lavoro dell'elemento.

ItemReferenceByVariable

Oggetto

Riferimento di un elemento per variabile.

Nome	Tipo	Descrizione
referenceType	string: ByVariable	Tipo di riferimento dell'elemento.
variableReference	string	Stringa di riferimento di variabile che specifica la libreria di variabili e il nome della variabile al suo interno. Format: `$(/**/_VarLibrary_/_VarName_)` per una libreria di variabili denominata VarLibrary e una variabile denominata VarName.

ItemReferenceType

Enumerazione

Tipo di riferimento dell'elemento. È possibile aggiungere altri tipi di ItemReferenceType nel tempo.

Valore	Descrizione
ById	L'elemento viene fatto riferimento dal relativo ID.
ByVariable	L'elemento viene fatto riferimento da una variabile.

LakehouseTablesDatasource

Oggetto

Un'origine dati DataAgent che usa una lakehouse in modalità solo tabelle.

Nome	Tipo	Descrizione
description	string	Descrizione dell'origine dati.
displayName	string	Nome visualizzato dell'origine dati.
id	string (uuid)	ID origine dati.
instructions	string	Istruzioni di intelligenza artificiale personalizzate specifiche per questa origine dati.
lakehouseReference	ItemReference: ItemReferenceById ItemReferenceByVariable	Oggetto di riferimento dell'elemento.
type	string: LakehouseTables	Il tipo di fonte dati.