Interfejs API REST usługi Power BI: łączenie danych SQL na żywo bez sterowników ODBC

Power BI · Interfejs API REST zamiast sterownika

Punkt Power BI w Interfejs API REST, nie jest sterownikiem bazy danych

Usługa Power BI zazwyczaj łączy się z bazą danych za pośrednictwem sterownika na komputerze, a w przypadku zaplanowanego odświeżania – za pośrednictwem bramy lokalnej. Punkt końcowy Query Streams to zwykły adres URL HTTPS, więc Power BI Desktop i usługa Power BI odczytują go za pomocą wbudowanego łącznika internetowego. Portal zapisuje kod Power Query M za Ciebie: Eksportuj → Power Query M (.pq)Wklej, dodaj klucz i gotowe. Ten sam plik działa w Excelu.

Około 5 minut Brak sterownika, brak bramy Dane pozostają w Twojej sieci Excel też

Co z tego wyjdzie?

Tabela Power BI zasilana zapisanym zapytaniem SQL przez HTTPS, odświeżalna w usłudze bez bramy lokalnej, ponieważ punkt końcowy wygląda jak dowolny interfejs API sieci Web. Sam punkt końcowy wygląda następująco w konsoli portalu:

{
  "miasto": „Seattle”
}

curl -X POST "https://api.querystreams.com/v1/endpoints/8f2c4d1e-6b3a-4f7e-9c21-5d0a7b3e2f19" \ -H "Klucz X-API: qsapi_TWÓJ_KLUCZ" \ -H "Typ zawartości: application/json" \ -d '{"miasto": "Seattle"}'

{
  „kolumny”: [ { "nazwa": „identyfikator_klienta”, "typ": "liczba całkowita" }, { "nazwa": "nazwa", "typ": "smyczkowy" }, { "nazwa": "miasto", "typ": "smyczkowy" } ],
  "wydziwianie": [
    { „identyfikator_klienta”: 1042, "nazwa": „Handlarze z Północnego Wiatru”, "miasto": „Seattle” },
    { „identyfikator_klienta”: 1057, "nazwa": „Alpine Outfitters”, "miasto": "Denver" },
    { „identyfikator_klienta”: 1063, "nazwa": „Harbour Foods”, "miasto": "Halifax" }
  ],
  "meta": { „liczba_wierszy”: 3, „czas_czasu_agenta_w_ms”: 41, „id_żądania”: „req_7Hq2mKd9” }
}

Powodem istnienia sterowników jest to, że Power BI musi komunikować się protokołem przewodowym każdej bazy danych z dowolnego miejsca, w którym jest uruchomiona, dlatego zaplanowane odświeżanie wymaga bramy w sieci. W przypadku punktu końcowego agent, który jest już połączony z bazą danych, uruchamia zapytanie, a api.querystreams.com odpowiada Power BI przez HTTPS. Power BI nie musi nic instalować ani usługa nie musi do niczego tunelować.

Czego będziesz potrzebować

Konto Query Streams

Każdy plan ma API REST. Wersja darmowa zapewnia jeden punkt końcowy, dwa klucze i 250 wierszy na wywołanie, co wystarcza do stworzenia tego przewodnika. Zarejestruj się na my.querystreams.com.

Agent na komputerze, który może uzyskać dostęp do własnej bazy danych, z dodanym połączeniem

Często jest to sam serwer bazy danych lub stale włączony komputer w tej samej sieci.

Zapisane zapytanie w Kreatorze zapytań

Punkt końcowy obejmuje dokładnie jedno zapisane zapytanie. Napisz SELECT, uruchom je raz i zapisz. Dodaj filtr dynamiczny (a @variable w klauzuli WHERE), jeśli wywołujący mają mieć możliwość filtrowania.

Plus Power BI Desktop lub Excel 2016 lub nowszy. Jeśli nie masz jeszcze punktu końcowego, Centrum API REST bazy danych prowadzi Cię od zapisanego zapytania do adresu URL w czterech krokach.

Połącz Power BI w czterech krokach

1. Eksportuj plik Power Query M

   W API otwórz swój punkt końcowy, kliknij Eksport i wybierz Power Query M (.pq)Plik jest kompletny wpuścić… wyrażenie z adresem URL punktu końcowego i parametrami wywoływalnymi, które są już na swoim miejscu. Wygląda to tak:

   Eksport · Power Query M (.pq)

   pozwalać
     Źródło = Json.Dokument(Sieć.Zawartość(
       „https://api.querystreams.com/v1/endpoints/8f2c4d1e-6b3a-4f7e-9c21-5d0a7b3e2f19”, [Nagłówki = [#„Klucz X-API” = „qsapi_TWÓJ_KLUCZ”], Zapytanie = [kompresja = "nic"]])), wiersze = Źródło[wiersze], tabela = Tabela.ZRekordów(wydziwianie)
   W
     tabela

   Eksport zawsze prosi o kompresja=brakponieważ Power Query nie potrafi dekodować ramek LZ4; Power BI oczekuje formatu JSON przesyłanego za pomocą pliku gzip.

2. Wklej do Power BI

   W Power BI Desktop wybierz Strona główna → Przekształć dane → Nowe źródło → Puste zapytanie, otwórz Zaawansowany edytor, zastąp jego zawartość plikiem i kliknij GotoweW programie Excel ścieżka jest taka Dane → Pobierz dane → Z innych źródeł → Puste zapytanie, a następnie ten sam Edytor zaawansowany.

3. Dodaj swój klucz

   Zastąp symbol zastępczy 49-znakowym kluczem początkowym qsapi_ z punktu końcowego Udostępnianie karta. Gdy Power BI zapyta, jak nawiązać połączenie, wybierz Anonimowy:klucz podróżuje w Klucz X-API nagłówek zapytania jest już ustawiony, więc nie jest potrzebna żadna akredytacja Power BI.

4. Załaduj i odśwież

   Kliknij Zamknij i zastosuj. Ten wydziwianie Tablica staje się tabelą z jedną kolumną na kolumnę zapytania. Opublikuj w usłudze Power BI i ustaw harmonogram odświeżania: ponieważ źródłem jest adres URL, nie jest wymagana brama lokalna. Każde odświeżenie to jedno wywołanie w punkcie końcowym. Działalność patka.

Żądanie wysyłane przez Power BI

Pod maską jest to to samo wywołanie, które można wykonać za pomocą curl. Parametry oznaczone jako Callable można przekazać z Power Query jako Zapytanie = [miasto = "Seattle"]:

curl "https://api.querystreams.com/v1/endpoints/8f2c4d1e-6b3a-4f7e-9c21-5d0a7b3e2f19?city=Seattle" \ -H "Klucz X-API: qsapi_TWÓJ_KLUCZ"

{
  „kolumny”: [ { "nazwa": „identyfikator_klienta”, "typ": "liczba całkowita" }, { "nazwa": "nazwa", "typ": "smyczkowy" }, { "nazwa": "miasto", "typ": "smyczkowy" } ],
  "wydziwianie": [
    { „identyfikator_klienta”: 1042, "nazwa": „Handlarze z Północnego Wiatru”, "miasto": „Seattle” },
    { „identyfikator_klienta”: 1057, "nazwa": „Alpine Outfitters”, "miasto": "Denver" },
    { „identyfikator_klienta”: 1063, "nazwa": „Harbour Foods”, "miasto": "Halifax" }
  ],
  "meta": { „liczba_wierszy”: 3, „czas_czasu_agenta_w_ms”: 41, „id_żądania”: „req_7Hq2mKd9” }
}

Wiersze powracają jako obiekty kluczowane nazwą kolumny, z listą kolumn i meta Blok, który informuje o liczbie wierszy, o tym, czy wynik został przycięty, oraz o identyfikatorze żądania, który można podać w cudzysłowie. To samo wywołanie, co POST, umieszcza parametry w treści JSON, co jest właściwym rozwiązaniem w przypadku długich list wartości:

curl -X POST "https://api.querystreams.com/v1/endpoints/8f2c4d1e-6b3a-4f7e-9c21-5d0a7b3e2f19" \ -H "Klucz X-API: qsapi_TWÓJ_KLUCZ" \ -H "Typ zawartości: application/json" \ -d '{"parametry": {"miasto": "Seattle"}}'

?format=csv

CSV zamiast JSON, dołączony wiersz nagłówka. Akceptuj: tekst/csv robi to samo. Punkty końcowe przesyłania strumieniowego zwracają NDJSON (jeden obiekt JSON na wiersz) z końcowym {"_summary": prawda, "liczba_wierszy": N} linia; sprawdź ostatnią linię.

?sample=true

Maksymalnie pięć rzędów, bez opłat. Dobre do podłączenia klienta.

?kompresja=lz4

Obudowa LZ4 przeznaczona do połączeń o dużej głośności z dekoderem; Kod Karta zawiera fragment kodu dekodera dla każdego języka. Zwykły gzip działa automatycznie, gdy klient wysyła Akceptuj kodowanie: gzip.

Autoryzacja: Nośnik qsapi_…

Zaakceptowano jako alias dla Klucz X-API. Użyj go z kodu przeglądarki.

Poza Power BI

Co pozwalają plany

Każde wywołanie ma również stały limit czasu zapytania wynoszący 60 sekund i limit odpowiedzi 8 MiB, a zwracane bajty wliczają się do miesięcznego limitu danych w ramach planu, takiego samego jak w przypadku dodatków do Excela i Arkuszy Google. Wersja darmowa ma jeden punkt końcowy i 5 MB transferu danych miesięcznie, co pozwala na wygodne wywoływanie małej tabeli wiele razy dziennie. Zobacz stronę z cennikiem dla dodatków według planu.

W przypadku raportu ogranicz zapytanie do kolumn, których potrzebują elementy wizualne, i pozwól, aby harmonogram odświeżania zajął się resztą. Usługa Power BI odczytuje cały wynik przy każdym odświeżeniu, więc statyczny limit wierszy w planie stanowi górną granicę pojedynczej tabeli.

Dbanie o bezpieczeństwo

Kiedy coś nie działa

Każdy błąd ma kształt {"błąd": {"kod": "…", "komunikat": "…"}} a każda odpowiedź niesie ze sobą Identyfikator żądania X-QS nagłówek. Podaj identyfikator, pisząc do pomocy technicznej.

Dwie specyfikacje Power Query: a Błąd źródła danych nazewnictwo 401 oznacza, że klucz w pliku M jest błędny lub został unieważniony; Wyrażenie. Błąd: Pole „wiersze” rekordu nie zostało znalezione oznacza, że punkt końcowy zwrócił kopertę błędu, więc uruchom adres URL w konsoli portalu, aby ją odczytać.

Pytania, które zadają ludzie

Powiązane przewodniki

• API REST bazy danych: zamień dowolne zapytanie SQL w punkt końcowy
• Interfejs API REST Microsoft SQL Server
• Interfejs API REST PostgreSQL
• Połącz interfejsy API REST z programem Excel bez użycia języka VBA lub narzędzia Power Query