Brugergrænsefladen i tekstbaseret forespørgselsdesigner (Power BI Report Builder)
GÆLDER FOR: 
Power BI Report Builder 
Power BI Desktop
Brug den tekstbaserede forespørgselsdesigner til at angive en forespørgsel ved hjælp af det forespørgselssprog, der understøttes af datakilden, kør forespørgslen, og få vist resultaterne på designtidspunktet. Du kan angive flere Transact-SQL-sætninger, forespørgsels- eller kommandosyntaks for brugerdefinerede databehandlingsudvidelser og forespørgsler, der er angivet som udtryk. Da den tekstbaserede forespørgselsdesigner ikke forbehandler forespørgslen og kan rumme nogen form for forespørgselssyntaks, er dette standardværktøjet til forespørgselsdesigneren for mange datakildetyper.
Vigtigt
Brugerne får adgang til datakilder, når de opretter og kører forespørgsler. Du skal give minimale tilladelser til datakilderne, f.eks. skrivebeskyttede tilladelser.
Den tekstbaserede forespørgselsdesigner viser en værktøjslinje og følgende to ruder:
Forespørgsel Viser forespørgselsteksten, tabelnavnet eller navnet på den lagrede procedure, afhængigt af forespørgselstypen. Ikke alle forespørgselstyper er tilgængelige for alle datakildetyper. Tabelnavn understøttes f.eks. kun for datakildetypen OLE DB.
Result Viser resultaterne af at køre forespørgslen på designtidspunktet.
Værktøjslinje i tekstbaseret forespørgselsdesigner
Den tekstbaserede forespørgselsdesigner indeholder en enkelt værktøjslinje til alle kommandotyper. I følgende tabel vises hver knap på værktøjslinjen og dens funktion.
| Knap | Beskrivelse |
|---|---|
| Rediger som tekst | Skift mellem den tekstbaserede forespørgselsdesigner og den grafiske forespørgselsdesigner. Det er ikke alle datakildetyper, der understøtter grafiske forespørgselsdesignere. |
| Import | Importér en eksisterende forespørgsel fra en fil eller rapport. Kun filtyper sql og rdl understøttes |
 |
Kør forespørgslen, og vis resultatsættet i ruden Resultat. |
| Kommandotype | Vælg Tekst, LagretProcedure eller TableDirect. Hvis en lagret procedure indeholder parametre, vises dialogboksen Definer forespørgselsparametre, når du vælger Kør på værktøjslinjen, og du kan udfylde værdier efter behov. Understøttelsen af kommandotypen varierer efter datakildetype. Det er f.eks. kun OLE DB og ODBC, der understøtter TableDirect. Bemærk! Hvis en lagret procedure returnerer mere end ét resultatsæt, bruges kun det første resultatsæt til at udfylde datasættet. |
Kommandotypetekst
Når du opretter et SQL Server-datasæt, åbnes relationsforespørgselsdesigneren som standard. Hvis du vil skifte til den tekstbaserede forespørgselsdesigner, skal du vælge knappen Rediger som tekst på værktøjslinjen. Den tekstbaserede forespørgselsdesigner præsenterer to ruder: ruden Forespørgsel og ruden Resultat. Følgende figur etiketterer hver rude.
I følgende tabel beskrives funktionen for hver rude.
| Ruden | Funktion |
|---|---|
| Anmodning | Viser teksten til Transact-SQL-forespørgslen. Brug denne rude til at skrive eller redigere en Transact-SQL-forespørgsel. |
| Resultat | Viser resultaterne af forespørgslen. Hvis du vil køre forespørgslen, skal du højreklikke i en rude og vælge Kør eller vælge knappen Kør på værktøjslinjen. |
Eksempel
Følgende forespørgsel returnerer listen over navne fra databasen ContactType i AdventureWorks2014 for personskemaet .
SELECT Name FROM Person.ContactType
Når du vælger Kør på værktøjslinjen, køres kommandoen i ruden Forespørgsel , og resultaterne vises i ruden Resultat . Resultatsættet viser en liste over 20 typer kontakter, f.eks. Ejer eller Salgsagent.
Lagret procedure for kommandotype
Når du vælger KommandotypeStoredProcedure, viser den tekstbaserede forespørgselsdesigner to ruder: ruden Forespørgsel og ruden Resultat. Angiv navnet på den lagrede procedure i ruden Forespørgsel, og vælg Kør på værktøjslinjen. Hvis den lagrede procedure bruger parametre, åbnes dialogboksen Definer forespørgselsparametre . Angiv parameterværdierne for den lagrede procedure. Der oprettes en rapportparameter for hver inputparameter for en lagret procedure.
I følgende figur vises ruderne Forespørgsel og Resultater, når du kører en lagret procedure. I dette tilfælde er inputparametrene konstanter.
I følgende tabel beskrives funktionen for hver rude.
| Ruden | Funktion |
|---|---|
| Anmodning | Viser navnet på den lagrede procedure og eventuelle inputparametre. |
| Resultat | Viser resultaterne af forespørgslen. Hvis du vil køre forespørgslen, skal du højreklikke i en rude og vælge Kør eller vælge knappen Kør på værktøjslinjen. |
Eksempel
Følgende forespørgsel kalder den lagrede procedure for AdventureWorks2014 uspGetWhereUsedProductID. Du skal angive en værdi for parameteren for produktidentifikationsnummer, når du kører forespørgslen.
uspGetWhereUsedProductID
Vælg knappen Kør (!). Når du bliver bedt om at angive forespørgselsparametrene, skal du bruge følgende tabel til at angive værdier.
| Parameter | Værdi |
|---|---|
| @StartProductID | 820 |
| @CheckDate | 20010115 |
For den angivne dato viser resultatsættet en liste over 13 produkt-id'er, der brugte det angivne komponentnummer.
Kommandotype TableDirect
Når du vælger KommandotypeTableDirect, viser den tekstbaserede forespørgselsdesigner to ruder: ruden Forespørgsel og ruden Resultat. Når du angiver en tabel og vælger knappen Kør , returneres alle kolonnerne for den pågældende tabel.
Eksempel
For en datakildetype OLE DB returnerer følgende datasætforespørgsel et resultatsæt for alle kontakttyper i Databasen AdventureWorks2014.
Person.ContactType
Når du angiver tabelnavnet Person.ContactType, svarer det til at oprette Transact-SQL-sætningen SELECT * FROM Person.ContactType.