Del via

Brukergrensesnitt for tekstbasert spørringsutforming (Power BI Report Builder)

  • Artikkel

GJELDER FOR: Power BI Report Builder Power BI Desktop

Bruk den tekstbaserte spørringsutformingen til å angi en spørring ved hjelp av spørringsspråket som støttes av datakilden, kjør spørringen og vis resultatene på utformingstidspunktet. Du kan angi flere Transact-SQL-setninger, spørrings- eller kommandosyntaks for egendefinerte databehandlingsutvidelser og spørringer som er angitt som uttrykk. Fordi den tekstbaserte spørringsutformingen ikke forhåndsberegner spørringen og har plass til en hvilken som helst type spørringssyntaks, er dette standard verktøy for spørringsutforming for mange datakildetyper.

Viktig

Brukere får tilgang til datakilder når de oppretter og kjører spørringer. Du bør gi minimale tillatelser for datakildene, for eksempel skrivebeskyttede tillatelser.

Den tekstbaserte spørringsutformingen viser en verktøylinje og følgende to ruter:

  • Spørring viser spørringsteksten, tabellnavnet eller navnet på den lagrede prosedyren, avhengig av spørringstypen. Ikke alle spørringstyper er tilgjengelige for alle datakildetyper. Tabellnavn støttes for eksempel bare for datakildetypen OLE DB.

  • Resultatet viser resultatene av å kjøre spørringen på utformingstidspunktet.

Verktøylinje for tekstbasert spørringsutforming

Den tekstbaserte spørringsutformingen har én enkelt verktøylinje for alle kommandotypene. Tabellen nedenfor viser hver knapp på verktøylinjen og funksjonen.

Knapp Bekrivelse
Rediger som tekst Veksle mellom den tekstbaserte spørringsutformingen og den grafiske spørringsutformingen. Ikke alle datakildetyper støtter grafiske spørringsutformere.
Importere Importer en eksisterende spørring fra en fil eller rapport. Bare filtyper sql og rdl støttes
Skjermbilde av Kjør spørring-ikonet. Kjør spørringen, og vis resultatsettet i resultatruten.
Kommandotype Merk tekst, StoredProcedure eller TableDirect. Hvis en lagret prosedyre har parametere, vises dialogboksen Definer spørringsparametere når du velger Kjør på verktøylinjen, og du kan fylle ut verdier etter behov. Støtte for kommandotype varierer etter datakildetype. Bare OLE DB og ODBC støtter for eksempel TableDirect.

Obs! Hvis en lagret prosedyre returnerer mer enn ett resultatsett, brukes bare det første resultatsettet til å fylle ut datasettet.

Kommandotypetekst

Når du oppretter et SQL Server-datasett, åpnes relasjonsspørringsutformingen som standard. Hvis du vil bytte til den tekstbaserte spørringsutformingen , velger du veksleknappen Rediger som tekst på verktøylinjen. Den tekstbaserte spørringsutformingen presenterer to ruter: spørringsruten og resultatruten. Følgende figur merker hver rute.

Diagram over generell spørringsutforming for relasjonsdataspørring.

Tabellen nedenfor beskriver funksjonen for hver rute.

Rute Function
Query Viser transact-SQL-spørringsteksten. Bruk denne ruten til å skrive eller redigere en Transact-SQL-spørring.
Resultat Viser resultatene av spørringen. Hvis du vil kjøre spørringen, høyreklikker du i en hvilken som helst rute og velger Kjør, eller velger Kjør-knappen på verktøylinjen.

Eksempel

Følgende spørring returnerer listen over navn fra Tabellen AdventureWorks2014-database ContactType for Person-skjemaet .

SELECT Name FROM Person.ContactType

Når du velger Kjør på verktøylinjen, kjøres kommandoen i spørringsruten , og resultatene vises i Resultat-ruten . Resultatsettet viser en liste over 20 typer kontakter, for eksempel eier eller salgsagent.

Kommandotype StoredProcedure

Når du velger KommandotypeStoredProcedure, presenterer den tekstbaserte spørringsutformingen to ruter: Spørringsruten og Resultat-ruten. Skriv inn navnet på den lagrede prosedyren i spørringsruten, og velg Kjør på verktøylinjen. Hvis den lagrede prosedyren bruker parametere, åpnes dialogboksen Definer spørringsparametere . Angi parameterverdiene for den lagrede prosedyren. En rapportparameter opprettes for alle inndataparametere for lagret prosedyre.

Illustrasjonen nedenfor viser spørrings- og resultatrutene når du kjører en lagret prosedyre. I dette tilfellet er inndataparameterne konstanter.

Diagram over lagret prosedyre i tekstbasert spørringsutforming.

Tabellen nedenfor beskriver funksjonen for hver rute.

Rute Function
Query Viser navnet på den lagrede prosedyren og eventuelle inndataparametere.
Resultat Viser resultatene av spørringen. Hvis du vil kjøre spørringen, høyreklikker du i en hvilken som helst rute og velger Kjør, eller velger Kjør-knappen på verktøylinjen.

Eksempel

Følgende spørring kaller adventureworks2014 lagret prosedyre uspGetWhereUsedProductID. Du må angi en verdi for parameteren for produktidentifikasjonsnummer når du kjører spørringen.

uspGetWhereUsedProductID

Velg Kjør (!)-knappen. Når du blir bedt om spørringsparameterne, bruker du tabellen nedenfor til å angi verdier.

Parameter Verdi
@StartProductID 820
@CheckDate 20010115

For den angitte datoen viser resultatsettet en liste over 13 produktidentifikatorer som brukte det angitte komponentnummeret.

Kommandotype TableDirect

Når du velger KommandotypeTableDirect, viser den tekstbaserte spørringsutformingen to ruter: Spørringsruten og Resultat-ruten. Når du skriver inn en tabell og velger Kjør-knappen , returneres alle kolonnene for tabellen.

Eksempel

For en datakildetype OLE DB returnerer følgende datasettspørring et resultatsett for alle kontakttyper i AdventureWorks2014-databasen.

Person.ContactType

Når du skriver inn tabellnavnet Person.ContactType, tilsvarer det å opprette Transact-SQL-setningen SELECT * FROM Person.ContactType.

Relatert innhold