Nawiązywanie połączenia przy użyciu funkcji Power Query i Azure DevOps

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Łącznik danych dla usługi Azure DevOps zawiera funkcje dodatku Power Query M, których mogą używać autorzy zapytań. Te funkcje mogą obsługiwać wymagania specyficzne dla usługi Azure DevOps, takie jak uwierzytelnianie. W tym artykule opisano argumenty funkcji i sposób ich używania do nawiązywania połączenia z usługą Analytics.

Funkcja VSTS.AccountContents zastępuje funkcję Web.Contents w Power Query M. Przeznaczona dla bardziej zaawansowanych scenariuszy, funkcja VSTS.AccountContents zwraca zawartość pobraną z adresu URL dla usługi Analytics jako wartość binarną. Służy do wywoływania interfejsów API REST usługi AzureDevOps.

Ważne

  • Użyj usługi VSTS. AccountContents tylko w celu uzyskania dostępu do danych, które nie są dostępne w usłudze Analytics. Pobiera ona dane bezpośrednio z usługi Azure DevOps i, aby chronić innych użytkowników usługi Azure DevOps, jest podatna na ograniczanie przepustowości. Zobacz sekcję Obsługiwane poddomeny dla VSTS.AccountContents w dalszej części tego artykułu. Aby uzyskać informacje o innych podejściach, zobacz Omówienie integracji usługi Power BI.
  • VSTS.AccountContents obsługuje tylko dane Azure Boards (elementy robocze). Łącznik danych nie obsługuje innych typów danych, takich jak potoki. Obecnie nie mamy planów aktualizacji łącznika w celu obsługi innych typów danych.

VSTS.AccountContents

Funkcja zaawansowana zwracająca zawartość pobraną z adresu URL dla usługi Analytics jako wartość binarną.

Funkcja VSTS.AccountContents ma te same argumenty, opcje i format wartości zwracanej co Web.Contents. Aby uzyskać więcej informacji, zobacz Power Query (M) Formula Reference - Web.Contents.

Jeśli już używasz Web.Contents do uzyskiwania dostępu do danych śledzenia pracy z usługi Analytics (interfejs API REST lub OData), możesz zastąpić go VSTS.AccountContents w celu użycia uwierzytelniania łącznika danych. Informuje usługę Power BI, że te żądania odwołują się do tego samego źródła danych. Dane można połączyć bez naruszania ograniczeń pojedynczego źródła danych w usłudze Power BI. VSTS.AccountContent Obsługuje jednak tylko dane z usługi Azure Boards i nie można ich używać do obsługi zapytań dotyczących potoków lub innych usług.

"VSTS.AccountContents" udostępnia podzbiór argumentów i opcji dostępnych za pośrednictwem elementu "OData.Contents". Konkretne ograniczenia opisano w poniższej tabeli:

Argumenty dla VSTS.Contents

Argument Description
url Adres URL do jednego z punktów końcowych usługi Azure DevOps.
options Rekord opcji do kontrolowania zachowania tej funkcji.

Pola opcji dla VSTS.Contents

(No changes needed) Description
IsRetry Określ tę wartość logiczną jako true, aby zignorować dowolną istniejącą odpowiedź w pamięci podręcznej podczas pobierania danych.
ManualStatusHandling Określ tę wartość jako listę, aby zapobiec każdej wbudowanej obsłudze żądań HTTP, których odpowiedź ma jeden z tych kodów stanu.
MaxSize Kontroluje maksymalny rozmiar tabeli, którą interesuje się klient. Jeśli żądanie przekroczy ten limit, serwer może od razu odrzucić żądanie. Wartość domyślna to zero, która nakazuje serwerowi użycie wartości domyślnej.
Query Programowe dodawanie parametrów zapytania do adresu URL.
RelativePath Określ tę wartość jako tekst dołącza ją do podstawowego adresu URL przed złożeniem żądania.
Timeout Określ tę wartość jako czas trwania, aby zmienić limit czasu dla żądania HTTP. Wartość domyślna to 600 sekund.
Version Wersja modelu danych. Ta opcja jest podstawowa dla diagnostyki.

Obsługiwane poddomeny dla usługi VSTS. AccountContents

VSTS.AccountContents() Obecnie metoda działa tylko dla poddomen wymienionych poniżej. Inne usługi, takie jak usługa Release, nie są jeszcze obsługiwane:

  • https://dev.azure.com/
  • https://analytics.dev.azure.com/
  • https://vsrm.dev.azure.com/

Treści powiązane

  • Last updated on