Staging - Update Datasource

Usługa:: DataAgent

Wersja interfejsu API:: v1

Aktualizuje metadane dla określonego przejściowego źródła danych określonego agenta DataAgent.

Note

Zarządzanie konfiguracją agenta danych jest obecnie dostępne w wersji zapoznawczej (dowiedz się więcej).

Tylko podane pola są aktualizowane.

Uprawnienia

Obiekt wywołujący musi mieć uprawnienia do odczytu i zapisu dla agenta DataAgent.

Wymagane zakresy delegowane

Item.ReadWrite.All lub DataAgent.ReadWrite.All

Tożsamości obsługiwane przez Microsoft Entra

To API obsługuje tożsamości Microsoft wymienione w tej sekcji.

Identity	Support
User	Tak
Główne usługi i Tożsamości zarządzane	Tak

Interfejs

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
dataAgentId	path	True	string (uuid)	Identyfikator agenta danych.
datasourceId	path	True	string (uuid)	Identyfikator źródła danych.
workspaceId	path	True	string (uuid)	Identyfikator przestrzeni roboczej.

Treść żądania

Nazwa	Typ	Opis
description	string	Opis źródła danych.
instructions	string	Niestandardowe instrukcje dotyczące sztucznej inteligencji specyficzne dla tego źródła danych.

Odpowiedzi

Nazwa Typ Opis

200 OK

Nazwa	Typ	Opis
200 OK	DataAgentDatasourceResponse: FabricItemDatasource LakehouseTablesDatasource	Żądanie zostało ukończone pomyślnie.
429 Too Many Requests	ErrorResponse	Przekroczono limit szybkości usługi. Serwer zwraca nagłówek wskazujący `Retry-After` w sekundach, jak długo klient musi czekać przed wysłaniem dodatkowych żądań. Nagłówki Retry-After: integer
Other Status Codes	ErrorResponse	Typowe kody błędów: ItemNotFound — żądany element nie został znaleziony. InvalidRequest — nieprawidłowe żądanie aktualizacji.

DataAgentDatasourceResponse:

FabricItemDatasource
LakehouseTablesDatasource

Żądanie zostało ukończone pomyślnie.

429 Too Many Requests

ErrorResponse

Przekroczono limit szybkości usługi. Serwer zwraca nagłówek wskazujący Retry-After w sekundach, jak długo klient musi czekać przed wysłaniem dodatkowych żądań.

Nagłówki

Retry-After: integer

Other Status Codes

ErrorResponse

Typowe kody błędów:

ItemNotFound — żądany element nie został znaleziony.
InvalidRequest — nieprawidłowe żądanie aktualizacji.

Przykłady

Update staging DataAgent datasource example

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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"
}

Definicje

Nazwa	Opis
DataAgentSupportedItemType	Obsługiwany typ elementu Fabric dla `FabricItem` źródła danych. Wartości używają nazw elementów publikowanych Fabric. Dodatkowe typy DataAgentSupportedItemType można dodawać z upływem czasu.
DatasourceType	Typ źródła danych. Dodatkowe typy DatasourceType można dodawać z upływem czasu.
ErrorRelatedResource	Obiekt szczegółowych informacji o zasobie związanym z błędem.
ErrorResponse	Odpowiedź na błąd.
ErrorResponseDetails	Szczegóły odpowiedzi na błąd.
FabricItemDatasource	Źródło danych DataAgent wspierane przez element Fabric.
ItemReferenceById	Odwołanie do elementu według obiektu ID.
ItemReferenceByVariable	Odwołanie do elementu według zmiennej.
ItemReferenceType	Typ odwołania do elementu. Dodatkowe typy `ItemReferenceType` można dodawać w czasie.
LakehouseTablesDatasource	Źródło danych DataAgent korzystające z magazynu typu lakehouse w trybie tylko w tabelach.
UpdateDataAgentDatasourceRequest	Zaktualizuj ładunek żądania źródła danych DataAgent. Tylko podane pola są aktualizowane.

DataAgentSupportedItemType

Wyliczenie

Obsługiwany typ elementu Fabric dla FabricItem źródła danych. Wartości używają nazw elementów publikowanych Fabric. Dodatkowe typy DataAgentSupportedItemType można dodawać z upływem czasu.

Wartość	Opis
Report	Power BI raport.
SemanticModel	Power BI semantyczny model.
Lakehouse	Jezioro.
KQLDatabase	Baza danych KQL.
Warehouse	Magazyn.
MirroredDatabase	Dublowana baza danych.
MirroredAzureDatabricksCatalog	Dublowany wykaz Azure Databricks.
GraphModel	Model grafu.
SQLDatabase	Baza danych SQL.
Ontology	Ontologia.

DatasourceType

Wyliczenie

Typ źródła danych. Dodatkowe typy DatasourceType można dodawać z upływem czasu.

Wartość	Opis
FabricItem	Źródło danych wspierane przez obsługiwany element Fabric.
LakehouseTables	Źródło danych wspierane przez usługę Lakehouse w trybie tylko do tabel.

ErrorRelatedResource

Objekt

Obiekt szczegółowych informacji o zasobie związanym z błędem.

Nazwa	Typ	Opis
resourceId	string	Identyfikator zasobu powiązany z błędem.
resourceType	string	Typ zasobu powiązanego z błędem.

ErrorResponse

Objekt

Odpowiedź na błąd.

Nazwa	Typ	Opis
errorCode	string	Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
isRetriable	boolean	Jeśli to prawda, żądanie można ponowić. Użyj nagłówka `Retry-After` odpowiedzi, aby określić opóźnienie, jeśli jest dostępne.
message	string	Czytelna reprezentacja błędu przez człowieka.
moreDetails	ErrorResponseDetails[]	Lista dodatkowych szczegółów błędu.
relatedResource	ErrorRelatedResource	Szczegóły zasobu powiązanego z błędem.
requestId	string (uuid)	Identyfikator żądania skojarzonego z błędem.

ErrorResponseDetails

Objekt

Szczegóły odpowiedzi na błąd.

Nazwa	Typ	Opis
errorCode	string	Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
message	string	Czytelna reprezentacja błędu przez człowieka.
relatedResource	ErrorRelatedResource	Szczegóły zasobu powiązanego z błędem.

FabricItemDatasource

Objekt

Źródło danych DataAgent wspierane przez element Fabric.

Nazwa	Typ	Opis
description	string	Opis źródła danych.
displayName	string	Nazwa wyświetlana źródła danych.
fabricItemType	DataAgentSupportedItemType	Typ elementu Fabric źródła danych.
id	string (uuid)	Identyfikator źródła danych.
instructions	string	Niestandardowe instrukcje dotyczące sztucznej inteligencji specyficzne dla tego źródła danych.
itemReference	ItemReference: ItemReferenceById ItemReferenceByVariable	Obiekt odwołania do elementu.
type	string: FabricItem	Typ źródła danych.

ItemReferenceById

Objekt

Odwołanie do elementu według obiektu ID.

Nazwa	Typ	Opis
itemId	string (uuid)	Identyfikator elementu.
referenceType	string: ById	Typ odwołania do elementu.
workspaceId	string (uuid)	Identyfikator obszaru roboczego elementu.

ItemReferenceByVariable

Objekt

Odwołanie do elementu według zmiennej.

Nazwa	Typ	Opis
referenceType	string: ByVariable	Typ odwołania do elementu.
variableReference	string	Ciąg odwołania do zmiennej, który określa bibliotekę zmiennych i nazwę zmiennej w niej. Format: `$(/**/_VarLibrary_/_VarName_)` dla biblioteki zmiennych o nazwie VarLibrary i zmiennej o nazwie VarName.

ItemReferenceType

Wyliczenie

Typ odwołania do elementu. Dodatkowe typy ItemReferenceType można dodawać w czasie.

Wartość	Opis
ById	Element jest przywołyyny przez jego identyfikator.
ByVariable	Element jest przywołyyny przez zmienną.

LakehouseTablesDatasource

Objekt

Źródło danych DataAgent korzystające z magazynu typu lakehouse w trybie tylko w tabelach.

Nazwa	Typ	Opis
description	string	Opis źródła danych.
displayName	string	Nazwa wyświetlana źródła danych.
id	string (uuid)	Identyfikator źródła danych.
instructions	string	Niestandardowe instrukcje dotyczące sztucznej inteligencji specyficzne dla tego źródła danych.
lakehouseReference	ItemReference: ItemReferenceById ItemReferenceByVariable	Obiekt odwołania do elementu.
type	string: LakehouseTables	Typ źródła danych.

UpdateDataAgentDatasourceRequest

Objekt

Zaktualizuj ładunek żądania źródła danych DataAgent. Tylko podane pola są aktualizowane.

Nazwa	Typ	Opis
description	string	Opis źródła danych.
instructions	string	Niestandardowe instrukcje dotyczące sztucznej inteligencji specyficzne dla tego źródła danych.