Běžné dotazy k programovému přístupu k analytickým datům

Tento článek se zabývá nejčastějšími dotazy ohledně programového přístupu k datům partnerských přehledů v Partnerské centrum.

Odpovědi rozhraní API

V jakých scénářích můžu obdržet jinou odpověď rozhraní API než 200 (úspěch)?

Tato tabulka popisuje odpovědi rozhraní API a postup, pokud je obdržíte.

Popis chyby Kód chyby Řešení potíží
Neautorizováno 401 Jedná se o výjimku ověřování. Zkontrolujte správnost tokenu Azure Active Directory (AAD). Token AAD je platný po dobu 60 minut, po které budete muset znovu vygenerovat token AAD.
Neplatný název tabulky 400 Název datové sady je nesprávný. Znovu zkontrolujte název datové sady voláním rozhraní API Get All Datasets.
Nesprávný název sloupce 400 Název sloupce v dotazu je nesprávný. Znovu zkontrolujte název sloupce voláním rozhraní API Get All Datasets nebo odkazujte na názvy sloupců v definicích dat.
Hodnota null nebo chybějící hodnota 400 V datové části požadavku rozhraní API možná chybí povinné parametry.
Neplatné parametry sestavy 400 Ujistěte se, že jsou parametry sestavy správné. Parametr RecurrenceInterval například může mít hodnotu menší než 4.
Interval opakování musí být mezi 4 a 2160. 400 Ujistěte se, že hodnota parametru požadavku RecurrenceInterval je mezi 4 a 2160.
Neplatné ID dotazu 400 Znovu zkontrolujte vygenerované ID dotazu.
Neplatné parametry sestavy pro vytvoření – Počáteční čas sestavy by měl být od aktuálního času UTC alespoň 4 hodiny. 400 Parametr Čas spuštění jako součást datové části požadavku by neměl být v minulosti. Počáteční čas sestavy by měl být alespoň 4 hodiny od aktuálního času UTC.
Požadovaná hodnota "string" se nenašla 400 Zkontrolujte, jestli jste aktualizovali parametry nebo callbackurl formát požadavku.
S danými filtry se nenašla žádná položka. 404 Zkontrolujte parametr reportID použitý v rozhraní API Get Report Executions.
Pro dané podmínky filtru nedošlo k žádnému spuštění. Po dokončení naplánovaného času spuštění sestavy zkontrolujte ID sestavy nebo ID spuštění a zkuste rozhraní API zopakovat. 404 Ujistěte se, že reportId je správné. Po naplánovaném čase spuštění sestavy, jak je uvedeno v datové části požadavku, zkuste rozhraní API zopakovat.
Při vytváření sestavy došlo k vnitřní chybě. ID korelace <> 500 Ujistěte se, že formát data pro pole StartTime, QueryStartTime a QueryEndTime je správný.
Nedostupná služba 500 Pokud se vám nepřetržitě zobrazí nedostupná služba (chyba 5xx), otevřete lístek podpory.

Žádné záznamy

Po stažení sestavy ze zabezpečeného umístění obdržím odpověď rozhraní API 200. Proč se mi neschytá žádné záznamy? Zkontrolujte, jestli řetězec v dotazu obsahuje jednu z přípustných hodnot pro záhlaví sloupce. Tento dotaz například vrátí nulové výsledky:

SELECT CustomerTenantId, CustomerTpId, WorkloadName, Month, MonthlyActiveUsers 
FROM OfficeUsage 
WHERE IsDuplicateRowForPGA = 'False' 
ORDER BY CustomerTenantId DESC

V tomto příkladu jsou možné hodnoty pro IsDuplicateRowForPGA hodnotu 0 nebo 1. Všechny možné hodnoty pro různé sloupce najdete v tématu Definice dat.