Interfejs użytkownika projektanta zapytań oparty na tekście (Power BI Report Builder)
DOTYCZY: 
Power BI Report Builder 
Power BI Desktop
Użyj projektanta zapytań opartego na tekście, aby określić zapytanie przy użyciu języka zapytań obsługiwanego przez źródło danych, uruchomić zapytanie i wyświetlić wyniki w czasie projektowania. Można określić wiele instrukcji Języka Transact-SQL, zapytań lub składni poleceń dla niestandardowych rozszerzeń przetwarzania danych i zapytań, które są określone jako wyrażenia. Ponieważ projektant zapytań oparty na tekście nie przetwarza wstępnie zapytania i może obsłużyć dowolną składnię zapytania, jest to domyślne narzędzie projektanta zapytań dla wielu typów źródeł danych.
Ważne
Użytkownicy uzyskują dostęp do źródeł danych podczas tworzenia i uruchamiania zapytań. Należy udzielić minimalnych uprawnień do źródeł danych, takich jak uprawnienia tylko do odczytu.
Projektant zapytań oparty na tekście wyświetla pasek narzędzi i następujące dwa okienka:
Zapytanie wyświetla tekst zapytania, nazwę tabeli lub nazwę procedury składowanej w zależności od typu zapytania. Nie wszystkie typy zapytań są dostępne dla wszystkich typów źródeł danych. Na przykład nazwa tabeli jest obsługiwana tylko dla typu źródła danych OLE DB.
Wynik przedstawia wyniki uruchamiania zapytania w czasie projektowania.
Pasek narzędzi projektanta zapytań opartych na tekście
Projektant zapytań oparty na tekście udostępnia jeden pasek narzędzi dla wszystkich typów poleceń. W poniższej tabeli wymieniono każdy przycisk na pasku narzędzi i jego funkcji.
| Przycisk | opis |
|---|---|
| Edytuj jako tekst | Przełącz się między projektantem zapytań opartym na tekście a graficznym projektantem zapytań. Nie wszystkie typy źródeł danych obsługują projektantów zapytań graficznych. |
| Importuj | Zaimportuj istniejące zapytanie z pliku lub raportu. Obsługiwane są tylko typy sql plików i rdl |
 |
Uruchom zapytanie i wyświetl zestaw wyników w okienku Wynik. |
| Typ polecenia | Wybierz pozycję Tekst, StoredProcedure lub TableDirect. Jeśli procedura składowana zawiera parametry, po wybraniu pozycji Uruchom na pasku narzędzi zostanie wyświetlone okno dialogowe Definiowanie parametrów zapytania i możesz w razie potrzeby wypełnić wartości. Obsługa typu polecenia różni się w zależności od typu źródła danych. Na przykład tylko bazy danych OLE DB i ODBC obsługują funkcję TableDirect. Uwaga: jeśli procedura składowana zwraca więcej niż jeden zestaw wyników, tylko pierwszy zestaw wyników jest używany do wypełniania zestawu danych. |
Tekst typu polecenia
Podczas tworzenia zestawu danych programu SQL Server projektant zapytań relacyjnych jest domyślnie otwierany. Aby przełączyć się do projektanta zapytań opartego na tekście, wybierz przycisk Przełącznik Edytuj jako tekst na pasku narzędzi. Projektant zapytań oparty na tekście przedstawia dwa okienka: okienko Zapytanie i okienko Wynik. Poniższe ilustracje etykietuje każde okienko.
W poniższej tabeli opisano funkcję każdego okienka.
| Pane | Function |
|---|---|
| Query | Wyświetla tekst zapytania Języka Transact-SQL. Użyj tego okienka, aby napisać lub edytować zapytanie Języka Transact-SQL. |
| Result | Wyświetla wyniki zapytania. Aby uruchomić zapytanie, kliknij prawym przyciskiem myszy dowolne okienko i wybierz polecenie Uruchom lub wybierz przycisk Uruchom na pasku narzędzi. |
Przykład
Poniższe zapytanie zwraca listę nazw z tabeli ContactType bazy danych AdventureWorks2014 dla schematu Person.
SELECT Name FROM Person.ContactType
Po wybraniu pozycji Uruchom na pasku narzędzi polecenie w okienku Zapytanie zostanie uruchomione, a wyniki zostaną wyświetlone w okienku Wynik . Zestaw wyników zawiera listę 20 typów kontaktów, na przykład Właściciel lub Agent sprzedaży.
Typ polecenia StoredProcedure
Po wybraniu pozycji Typ poleceniaStoredProcedure projektant zapytań oparty na tekście przedstawia dwa okienka: okienko Zapytania i okienko Wynik. Wprowadź nazwę procedury składowanej w okienku Zapytanie i wybierz pozycję Uruchom na pasku narzędzi. Jeśli procedura składowana używa parametrów, zostanie otwarte okno dialogowe Definiowanie parametrów zapytania. Wprowadź wartości parametrów dla procedury składowanej. Parametr raportu jest tworzony dla każdego parametru wejściowego procedury składowanej.
Na poniższej ilustracji przedstawiono okienka Zapytania i wyniki po uruchomieniu procedury składowanej. W tym przypadku parametry wejściowe są stałymi.
W poniższej tabeli opisano funkcję każdego okienka.
| Pane | Function |
|---|---|
| Query | Wyświetla nazwę procedury składowanej i wszystkie parametry wejściowe. |
| Result | Wyświetla wyniki zapytania. Aby uruchomić zapytanie, kliknij prawym przyciskiem myszy dowolne okienko i wybierz polecenie Uruchom lub wybierz przycisk Uruchom na pasku narzędzi. |
Przykład
Poniższe zapytanie wywołuje procedurę składowaną AdventureWorks2014 uspGetWhereUsedProductID. Podczas uruchamiania zapytania należy wprowadzić wartość parametru numeru identyfikacyjnego produktu.
uspGetWhereUsedProductID
Wybierz przycisk Uruchom (!). Po wyświetleniu monitu o parametry zapytania użyj poniższej tabeli, aby wprowadzić wartości.
| Parametr | Wartość |
|---|---|
| @StartProductID | 820 |
| @CheckDate | 20010115 |
Dla określonej daty zestaw wyników wyświetla listę 13 identyfikatorów produktów, które używały określonego numeru składnika.
Typ polecenia TableDirect
Po wybraniu pozycji Typ poleceniaTableDirect projektant zapytań oparty na tekście przedstawia dwa okienka: okienko Zapytanie i okienko Wynik. Po wprowadzeniu tabeli i wybraniu przycisku Uruchom zostaną zwrócone wszystkie kolumny dla tej tabeli.
Przykład
W przypadku typu źródła danych OLE DB następujące zapytanie zestawu danych zwraca zestaw wyników dla wszystkich typów kontaktów w bazie danych AdventureWorks2014.
Person.ContactType
Po wprowadzeniu nazwy tabeli Person.ContactType jest to odpowiednik tworzenia instrukcji SELECT * FROM Person.ContactTypeJęzyka Transact-SQL.