Share via

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

  • Artykuł

Azure DevOps Services | Azure DevOps Server 2022 r. — Azure DevOps Server 2019 r.

Łącznik danych dla usługi Azure DevOps zawiera funkcje Power Query M, których mogą używać autorzy zapytań. Te funkcje mogą obsługiwać określone wymagania dotyczące 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.

Usługa VSTS. Funkcja AccountContents jest zamiennikiem funkcji Power Query M Web.Contents. Przeznaczony dla bardziej zaawansowanych scenariuszy, VSTS. Funkcja AccountContents zwraca zawartość pobraną z adresu URL dla usługi Analytics jako wartość binarną. Można go użyć do wywoływania interfejsów API REST usługi AzureDevOps.

Ważne

  • Użyj usługi VSTS. KontoContents 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 obsługiwane poddomeny dla usługi VSTS. Sekcja AccountContents w dalszej części tego artykułu. Aby uzyskać informacje o innych podejściach, zobacz Omówienie integracji usługi Power BI.
  • VSTS. Usługa AccountContents obsługuje tylko dane Azure Boards (elementy robocze). Łącznik danych nie obsługuje innych typów danych, takich jak potoki. Obecnie nie planujemy zaktualizować łą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 informacje o formułach Power Query (M) — Web.Contents.

Jeśli używasz już Web.Contents dostępu do danych śledzenia pracy z usługi Analytics (interfejs API REST lub OData), możesz zastąpić ją VSTS.AccountContents za pomocą uwierzytelniania łącznika danych. Informuje ona usługę Power BI, że te żądania odwołują się do tego samego źródła danych. Dane można połączyć bez naruszenia ograniczeń pojedynczego źródła danych w usłudze Power BI. VSTS.AccountContent Jednak obsługuje tylko dane z 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". Określone ograniczenia zostały opisane w poniższej tabeli:

Argumenty usługi VSTS. Zawartość

Argument Opis
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 usługi VSTS. Zawartość

Pole Opis
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 jakiejkolwiek wbudowanej obsłudze żądań HTTP, których odpowiedź ma jeden z tych kodów stanu.
MaxSize Steruje maksymalnym rozmiarem tabeli, w ramach których interesuje się klient. Jeśli żądanie przekroczy ten limit, serwer może natychmiast zakończyć żądanie niepowodzeniem. Wartość domyślna to zero, co informuje serwer serwerów o użyciu jego 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 wykonaniem żądania.
Timeout Określ tę wartość jako czas trwania, co spowoduje zmianę limitu czasu dla żądania HTTP. Wartość domyślna to 600 sekund.
Version Wersja modelu danych. Ta opcja jest podstawowa do diagnostyki.

Obsługiwane poddomeny dla usługi VSTS. AccountContents

VSTS.AccountContents() Obecnie metoda działa tylko dla poddomeny 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/