Gebruikersinterface voor queryontwerp op basis van tekst (Power BI Report Builder)
VAN TOEPASSING OP:
Power BI Report Builder 
Power BI Desktop
Gebruik de ontwerpfunctie voor query's op basis van tekst om een query op te geven met behulp van de querytaal die wordt ondersteund door de gegevensbron, voer de query uit en bekijk de resultaten tijdens het ontwerp. U kunt meerdere Transact-SQL-instructies, query- of opdrachtsyntaxis opgeven voor aangepaste extensies voor gegevensverwerking en query's die zijn opgegeven als expressies. Omdat de ontwerpfunctie voor tekstquery's de query niet vooraf verwerkt en geschikt is voor elk type querysyntaxis, is dit het standaardhulpprogramma voor het ontwerpen van query's voor veel typen gegevensbronnen.
Belangrijk
Gebruikers hebben toegang tot gegevensbronnen wanneer ze query's maken en uitvoeren. U moet minimale machtigingen verlenen voor de gegevensbronnen, zoals alleen-lezenmachtigingen.
In de ontwerpfunctie voor tekstquery's wordt een werkbalk en de volgende twee deelvensters weergegeven:
Query toont de querytekst, tabelnaam of opgeslagen procedurenaam, afhankelijk van het querytype. Niet alle querytypen zijn beschikbaar voor alle gegevensbrontypen. Tabelnaam wordt bijvoorbeeld alleen ondersteund voor het gegevensbrontype OLE DB.
Resultaat Toont de resultaten van het uitvoeren van de query tijdens het ontwerp.
Werkbalk Op tekst gebaseerde ontwerpfunctie voor query's
De ontwerpfunctie voor query's op basis van tekst biedt één werkbalk voor alle opdrachttypen. De volgende tabel bevat elke knop op de werkbalk en de bijbehorende functie.
| Knop | Beschrijving |
|---|---|
| Bewerken als tekst | Schakelen tussen de ontwerpfunctie voor tekstgebaseerde query's en de grafische ontwerpfunctie voor query's. Niet alle gegevensbrontypen ondersteunen grafische queryontwerpers. |
| Importeren | Importeer een bestaande query uit een bestand of rapport. Alleen bestandstypen sql en rdl worden ondersteund |
 |
Voer de query uit en geef de resultatenset weer in het deelvenster Resultaat. |
| Opdrachttype | Selecteer Tekst, StoredProcedure of TableDirect. Als een opgeslagen procedure parameters bevat, wordt het dialoogvenster Queryparameters definiëren weergegeven wanneer u Uitvoeren op de werkbalk selecteert en kunt u indien nodig waarden invullen. Ondersteuning voor het opdrachttype verschilt per gegevensbrontype. Zo ondersteunen alleen OLE DB en ODBC TableDirect. Opmerking: als een opgeslagen procedure meer dan één resultatenset retourneert, wordt alleen de eerste resultatenset gebruikt om de gegevensset te vullen. |
Opdrachttype Tekst
Wanneer u een SQL Server-gegevensset maakt, wordt de ontwerpfunctie voor relationele query's standaard geopend. Als u wilt overschakelen naar de ontwerpfunctie voor query's op basis van tekst, selecteert u de wisselknop Bewerken als tekst op de werkbalk. De ontwerpfunctie voor query's op basis van tekst bevat twee deelvensters: het deelvenster Query en het resultaatvenster. In de volgende afbeelding wordt elk deelvenster gelabeld.
In de volgende tabel wordt de functie van elk deelvenster beschreven.
| Deelvenster | Functie |
|---|---|
| Query’s uitvoeren | Geeft de Transact-SQL-querytekst weer. Gebruik dit deelvenster om een Transact-SQL-query te schrijven of te bewerken. |
| Resultaat | Geeft de resultaten van de query weer. Als u de query wilt uitvoeren, klikt u met de rechtermuisknop in een deelvenster en selecteert u Uitvoeren of selecteert u de knop Uitvoeren op de werkbalk. |
Opmerking
De volgende query retourneert de lijst met namen uit de database ContactType-tabel AdventureWorks2014 voor het person-schema .
SELECT Name FROM Person.ContactType
Wanneer u Uitvoeren op de werkbalk selecteert, wordt de opdracht in het deelvenster Query uitgevoerd en worden de resultaten weergegeven in het deelvenster Resultaat. In de resultatenset wordt een lijst met 20 typen contactpersonen weergegeven, bijvoorbeeld Eigenaar of Verkoopagent.
Opdrachttype StoredProcedure
Wanneer u Command typeStoredProcedure selecteert, worden in de ontwerpfunctie voor tekstquery's twee deelvensters weergegeven: het deelvenster Query en het resultaatvenster. Voer de naam van de opgeslagen procedure in het deelvenster Query in en selecteer Uitvoeren op de werkbalk. Als de opgeslagen procedure parameters gebruikt, wordt het dialoogvenster Queryparameters definiëren geopend. Voer de parameterwaarden in voor de opgeslagen procedure. Er wordt een rapportparameter gemaakt voor elke opgeslagen procedureinvoerparameter.
In de volgende afbeelding ziet u de deelvensters Query en Resultaten wanneer u een opgeslagen procedure uitvoert. In dit geval zijn de invoerparameters constanten.
In de volgende tabel wordt de functie van elk deelvenster beschreven.
| Deelvenster | Functie |
|---|---|
| Query’s uitvoeren | Geeft de naam van de opgeslagen procedure en eventuele invoerparameters weer. |
| Resultaat | Geeft de resultaten van de query weer. Als u de query wilt uitvoeren, klikt u met de rechtermuisknop in een deelvenster en selecteert u Uitvoeren of selecteert u de knop Uitvoeren op de werkbalk. |
Opmerking
De volgende query roept de opgeslagen procedure AdventureWorks2014 uspGetWhereUsedProductID aan. U moet een waarde invoeren voor de parameter productidentificatienummer wanneer u de query uitvoert.
uspGetWhereUsedProductID
Selecteer de knop Uitvoeren (!). Wanneer u om de queryparameters wordt gevraagd, gebruikt u de volgende tabel om waarden in te voeren.
| Parameter | Weergegeven als |
|---|---|
| @StartProductID | 820 |
| @CheckDate | 20010115 |
Voor de opgegeven datum geeft de resultatenset een lijst weer met 13 product-id's die het opgegeven onderdeelnummer hebben gebruikt.
Opdrachttype TableDirect
Wanneer u Command typeTableDirect selecteert, worden in de ontwerpfunctie voor tekstquery's twee deelvensters weergegeven: het deelvenster Query en het resultaatvenster. Wanneer u een tabel invoert en de knop Uitvoeren selecteert, worden alle kolommen voor die tabel geretourneerd.
Opmerking
Voor een gegevensbrontype OLE DB retourneert de volgende gegevenssetquery een resultatenset voor alle typen contactpersonen in de Database AdventureWorks2014.
Person.ContactType
Wanneer u de tabelnaam Person.ContactType invoert, is dit het equivalent van het maken van de Transact-SQL-instructie SELECT * FROM Person.ContactType.