Staging - Update Datasource

Tjeneste:: DataAgent

API-versjon:: v1

Oppdaterer metadata for en bestemt oppsamlingsdatakilde for den angitte DataAgent.

Obs!

Konfigurasjonsbehandling for dataagent er for øyeblikket i forhåndsvisning (finn ut mer).

Bare angitte felt oppdateres.

Tillatelser

Innringeren må ha lese- og skrivetillatelser for DataAgent.

Nødvendige delegerte omfang

Item.ReadWrite.All eller DataAgent.ReadWrite.All

Microsoft Entra støttede identiteter

Denne API-en støtter Microsoft identiteter oppført i denne delen.

Identity	Kundestøtte
Bruker	Ja
tjenestekontohaver og administrerte identiteter	Ja

Grensesnitt

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

URI-parametere

Navn	I	Obligatorisk	Type	Beskrivelse
dataAgentId	path	True	string (uuid)	DataAgent-ID-en.
datasourceId	path	True	string (uuid)	Datakilde-ID-en.
workspaceId	path	True	string (uuid)	Arbeidsområde-ID-en.

Brødtekst for forespørsel

Navn	Type	Beskrivelse
description	string	Beskrivelsen av datakilden.
instructions	string	Egendefinerte AI-instruksjoner som er spesifikke for denne datakilden.

Svar

Navn Type Beskrivelse

200 OK

Navn	Type	Beskrivelse
200 OK	DataAgentDatasourceResponse: FabricItemDatasource LakehouseTablesDatasource	Forespørselen er fullført.
429 Too Many Requests	ErrorResponse	Grensen for tjenestesats ble overskredet. Serveren returnerer en `Retry-After` topptekst som angir, i sekunder, hvor lenge klienten må vente før du sender flere forespørsler. Overskrifter Retry-After: integer
Other Status Codes	ErrorResponse	Vanlige feilkoder: ItemNotFound – Finner ikke det forespurte elementet. InvalidRequest – ugyldig oppdateringsforespørsel.

DataAgentDatasourceResponse:

FabricItemDatasource
LakehouseTablesDatasource

Forespørselen er fullført.

429 Too Many Requests

ErrorResponse

Grensen for tjenestesats ble overskredet. Serveren returnerer en Retry-After topptekst som angir, i sekunder, hvor lenge klienten må vente før du sender flere forespørsler.

Overskrifter

Retry-After: integer

Other Status Codes

ErrorResponse

Vanlige feilkoder:

ItemNotFound – Finner ikke det forespurte elementet.
InvalidRequest – ugyldig oppdateringsforespørsel.

Eksempler

Update staging DataAgent datasource example

Eksempelforespørsel

HTTP

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

{
  "instructions": "Use this for document retrieval queries.",
  "description": "Sales data warehouse with order and customer information."
}

Eksempelsvar

Statuskode:: 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"
}

Definisjoner

Navn	Beskrivelse
DataAgentSupportedItemType	Den støttede Fabric elementtypen for en `FabricItem` datakilde. Verdier bruker publiserte Fabric elementnavn. Flere DataAgentSupportedItemType-typer kan legges til over tid.
DatasourceType	Datakildetypen. Flere DatasourceType-typer kan legges til over tid.
ErrorRelatedResource	Objektet for feilrelaterte ressursdetaljer.
ErrorResponse	Feilsvaret.
ErrorResponseDetails	Feilsvardetaljene.
FabricItemDatasource	En DataAgent-datakilde støttet av et Fabric element.
ItemReferenceById	En elementreferanse av ID-objekt.
ItemReferenceByVariable	En elementreferanse etter variabel.
ItemReferenceType	Elementreferansetypen. Flere `ItemReferenceType` typer kan legges til over tid.
LakehouseTablesDatasource	En DataAgent-datakilde som bruker et lakehouse i tabellmodus.
UpdateDataAgentDatasourceRequest	Oppdater nyttelast for dataagentdatakildeforespørsel. Bare angitte felt oppdateres.

DataAgentSupportedItemType

Opplisting

Den støttede Fabric elementtypen for en FabricItem datakilde. Verdier bruker publiserte Fabric elementnavn. Flere DataAgentSupportedItemType-typer kan legges til over tid.

Verdi	Beskrivelse
Report	Power BI-rapport.
SemanticModel	Power BI semantisk modell.
Lakehouse	Et innsjøhus.
KQLDatabase	En KQL-database.
Warehouse	Et lager.
MirroredDatabase	En speilvendt database.
MirroredAzureDatabricksCatalog	En speilet Azure Databricks katalog.
GraphModel	En grafmodell.
SQLDatabase	En SQL-database.
Ontology	En ontologi.

DatasourceType

Opplisting

Datakildetypen. Flere DatasourceType-typer kan legges til over tid.

Verdi	Beskrivelse
FabricItem	En datakilde støttet av et støttet Fabric element.
LakehouseTables	En datakilde støttet av et lakehouse i tabellmodus.

ErrorRelatedResource

Objekt

Objektet for feilrelaterte ressursdetaljer.

Navn	Type	Beskrivelse
resourceId	string	Ressurs-ID-en som er involvert i feilen.
resourceType	string	Typen ressurs som er involvert i feilen.

ErrorResponse

Objekt

Feilsvaret.

Navn	Type	Beskrivelse
errorCode	string	En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
isRetriable	boolean	Når sann, kan forespørselen prøves på nytt. `Retry-After` Bruk svarhodet til å fastslå forsinkelsen, hvis tilgjengelig.
message	string	En menneskelig lesbar representasjon av feilen.
moreDetails	ErrorResponseDetails[]	Liste over flere feildetaljer.
relatedResource	ErrorRelatedResource	Feilrelaterte ressursdetaljer.
requestId	string (uuid)	ID for forespørselen som er knyttet til feilen.

ErrorResponseDetails

Objekt

Feilsvardetaljene.

Navn	Type	Beskrivelse
errorCode	string	En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
message	string	En menneskelig lesbar representasjon av feilen.
relatedResource	ErrorRelatedResource	Feilrelaterte ressursdetaljer.

FabricItemDatasource

Objekt

En DataAgent-datakilde støttet av et Fabric element.

Navn	Type	Beskrivelse
description	string	Beskrivelsen av datakilden.
displayName	string	Visningsnavnet for datakilden.
fabricItemType	DataAgentSupportedItemType	Den Fabric elementtypen for datakilden.
id	string (uuid)	Datakilde-ID-en.
instructions	string	Egendefinerte AI-instruksjoner som er spesifikke for denne datakilden.
itemReference	ItemReference: ItemReferenceById ItemReferenceByVariable	Et elementreferanseobjekt.
type	string: FabricItem	Datakildetypen.

ItemReferenceById

Objekt

En elementreferanse av ID-objekt.

Navn	Type	Beskrivelse
itemId	string (uuid)	ID-en for elementet.
referenceType	string: ById	Elementreferansetypen.
workspaceId	string (uuid)	Arbeidsområde-ID-en for elementet.

ItemReferenceByVariable

Objekt

En elementreferanse etter variabel.

Navn	Type	Beskrivelse
referenceType	string: ByVariable	Elementreferansetypen.
variableReference	string	En variabel referansestreng som angir variabelbiblioteket og variabelnavnet i den. Format: `$(/**/_VarLibrary_/_VarName_)` for et variabelbibliotek kalt VarLibrary og en variabel kalt VarName.

ItemReferenceType

Opplisting

Elementreferansetypen. Flere ItemReferenceType typer kan legges til over tid.

Verdi	Beskrivelse
ById	Elementet refereres av ID-en.
ByVariable	Elementet refereres av en variabel.

LakehouseTablesDatasource

Objekt

En DataAgent-datakilde som bruker et lakehouse i tabellmodus.

Navn	Type	Beskrivelse
description	string	Beskrivelsen av datakilden.
displayName	string	Visningsnavnet for datakilden.
id	string (uuid)	Datakilde-ID-en.
instructions	string	Egendefinerte AI-instruksjoner som er spesifikke for denne datakilden.
lakehouseReference	ItemReference: ItemReferenceById ItemReferenceByVariable	Et elementreferanseobjekt.
type	string: LakehouseTables	Datakildetypen.

UpdateDataAgentDatasourceRequest

Objekt

Oppdater nyttelast for dataagentdatakildeforespørsel. Bare angitte felt oppdateres.

Navn	Type	Beskrivelse
description	string	Beskrivelsen av datakilden.
instructions	string	Egendefinerte AI-instruksjoner som er spesifikke for denne datakilden.