Query's schrijven en gegevens verkennen in de nieuwe SQL-editor

Belangrijk

Deze functie bevindt zich in openbare preview-versie.

De Databricks-gebruikersinterface bevat een SQL-editor die u kunt gebruiken om query's te maken, samen te werken met collega's, door beschikbare gegevens te bladeren en visualisaties te maken. Op deze pagina wordt uitgelegd hoe u de SQL-editor gebruikt om query's te schrijven, uit te voeren, te beheren en te delen.

In dit artikel wordt uitgelegd hoe u de nieuwe SQL-editor gebruikt. Zie Query's schrijven en gegevens verkennen in de verouderde SQL-editor voor meer informatie over het werken met de verouderde SQL-editor.

De SQL-editor openen

Als u de SQL-editor wilt openen in de gebruikersinterface van Azure Databricks, klikt u op SQL Editor in de zijbalk.

De SQL-editor wordt geopend voor uw laatste geopende query. Als er geen query bestaat of als al uw query's expliciet zijn gesloten, wordt de landingspagina van de SQL-editor geopend.

De nieuwe SQL-editor inschakelen

Gebruik de wisselknop Nieuwe SQL-editor rechts van de catalogus- en schemaselectors om de nieuwe editor in te schakelen. Op smalle beeldschermen kunt u de wisselknop Nieuwe SQL-editor vinden door te klikken op het rechts van de catalogus- en schemaselectors.

Schakel de nieuwe editor in voor elke query die u bezit:

• Klik op Nieuwe SQL-editor: UIT. Er wordt een pop-overmenu voor een nieuwe SQL-editor geopend.
  • Het selectievakje Toepassen op al mijn query's is standaard ingeschakeld. Behoud deze instelling om de editor in te schakelen voor alle query's die u bezit.
  • Als u de nieuwe editor alleen voor de actieve query wilt inschakelen, schakelt u het selectievakje Toepassen op al mijn query's uit .
• Stel de Nieuwe SQL-editor in wisselknop in op ON-.

De nieuwe SQL-editor kan niet worden gebruikt voor alle query's. U kunt niet overschakelen naar de nieuwe SQL-editor voor een query als een van de volgende waar is:

• U bent niet de eigenaar van de query.
• De query bevat vervolgkeuzelijsten op basis van query's, die niet worden ondersteund. Zie Het werken met queryparameters.

Wanneer u de nieuwe SQL-editor inschakelt, wordt uw query opnieuw geopend in de nieuwe gebruikersinterface. De resultatenset is leeg totdat u de query uitvoert.

Notitie

Queryresultaten worden gedeeld met alle medewerkers en zijn beperkt tot 64.000 rijen.

Oriëntatie

In deze sectie worden belangrijke verschillen in de gebruikersinterface gemarkeerd en wordt uitgelegd hoe u beschikbare functies kunt vinden en gebruiken.

1. Toegang tot het bestandssysteem van de werkruimte: u kunt uw werkruimteobjecten rechtstreeks vanuit de SQL-editor openen en organiseren.
2. Gebruik de geïntegreerde Databricks-assistent: chat met de assistent om u te helpen bij het schrijven, verfijnen of begrijpen van query's. Voer code uit die is gegenereerd door de assistent vanuit het zijpaneel.
3. Secties met code samenvouwen: klik op de pijl links van een codeblok om codesecties selectief te verbergen en uit te vouwen. Dit kan het werken met grote bestanden vereenvoudigen.
4. Open het opdrachtenpalet: het opdrachtenpalet bevat veelgebruikte acties, sneltoetsen, aangepaste thema's en koppelingen waarmee u snel kunt vinden wat u nodig hebt. Nadat u deze hebt geopend, gebruikt u de zoekbalk om te zoeken naar specifieke hulpprogramma's en snelkoppelingen.
5. Opmerking bij code: opmerkingen toevoegen aan code om de samenwerking te verbeteren.
6. Versiegeschiedenis controleren: Bekijk recente wijzigingen in uw query.

Verbinding maken met compute

U moet ten minste MACHTIGINGEN VOOR HET GEBRUIK VAN EEN SQL-warehouse hebben om query's uit te voeren. U kunt de vervolgkeuzelijst boven aan de editor gebruiken om de beschikbare opties te bekijken. Als u de lijst wilt filteren, voert u tekst in het tekstvak in.

De eerste keer dat u een query maakt, wordt de lijst met beschikbare SQL-warehouses alfabetisch weergegeven. Het laatst gebruikte SQL Warehouse wordt geselecteerd wanneer u de volgende keer een query maakt.

Het pictogram naast het SQL Warehouse geeft de status aan:

• Lopend
• Beginnend
• Gestopt

Notitie

Als er geen SQL-warehouses in de lijst staan, neemt u contact op met de beheerder van uw werkruimte.

Het geselecteerde SQL Warehouse wordt automatisch opnieuw opgestart wanneer u uw query uitvoert. Zie Een SQL-warehouse starten voor meer informatie over andere manieren om een SQL-warehouse te starten.

Navigeer door assets en krijg hulp

Gebruik het linkerdeelvenster in de SQL-editor om door werkruimtebestanden te bladeren, gegevensobjecten weer te geven en hulp te krijgen van Databricks Assitant.

Door werkruimtebestanden bladeren

Klik op het mappictogram om uw werkruimte-gebruikersmap te openen. U kunt navigeren in alle werkruimtebestanden waar u toegang toe hebt vanuit dit deel van de gebruikersinterface.

Door gegevensobjecten bladeren

Als u leesmachtigingen voor metagegevens hebt, worden in de schemabrowser in de SQL-editor de beschikbare databases en tabellen weergegeven. U kunt ook door gegevensobjecten bladeren vanuit Catalog Explorer.

U kunt navigeren in databaseobjecten van Unity Catalog in Catalog Explorer zonder actieve rekenkracht. Als u gegevens in de hive_metastore en andere catalogi wilt verkennen die niet worden beheerd door Unity Catalog, moet u verbinden met compute met de juiste bevoegdheden. Zie Gegevensbeheer met Azure Databricks.

Notitie

Als er geen gegevensobjecten bestaan in de schemabrowser of Catalog Explorer, neemt u contact op met de werkruimtebeheerder.

Klik op het pictogram , boven aan de schemabrowser, om het schema te vernieuwen. U kunt in de zoekbalk typen om assets op naam te filteren. Klik op het filterpictogram om objecten te filteren op type.

Klik op de naam van een object in de browser voor meer informatie over het object. Klik bijvoorbeeld op een schemanaam om de tabellen in dat schema weer te geven. Klik op een tabelnaam om de kolommen in die tabel weer te geven.

Hulp krijgen van Databricks Assistant

Klik op Klik op het pictogram Assistent om een chatvenster te openen met Databricks Assistant. Klik op een voorgestelde vraag of voer uw eigen vraag in om te communiceren met Databricks Assistant.

Een query maken

U kunt tekst invoeren om een query te maken in de SQL-editor. U kunt elementen uit de schemabrowser invoegen om te verwijzen naar catalogi en tabellen.

1. Typ uw query in de SQL-editor.

   De SQL-editor ondersteunt automatisch aanvullen. Terwijl u typt, worden met automatisch aanvullen voltooiingen voorgesteld. Als een geldige voltooiing op de cursorlocatie bijvoorbeeld een kolom is, stelt automatisch aanvullen een kolomnaam voor. Als u select * from table_name as t where t.typt, herkent de automatische aanvulling dat t een alias is voor table_name en stelt de kolommen in table_namevoor. U kunt ook autocomplete gebruiken om te verwijzen naar queryfragmenten.

   

2. (Optioneel) Wanneer u klaar bent met bewerken, klikt u op Opslaan. De query wordt standaard opgeslagen in de basismap van uw gebruiker. Als u de query op een andere locatie wilt opslaan, selecteert u de doelmap en klikt u op Verplaatsen.

Notitie

Nieuwe query's krijgen automatisch de naam Nieuwe query , waarbij de tijdstempel voor het maken is toegevoegd aan de titel. Nieuwe query's die zijn gemaakt zonder een specifieke mapcontext, worden standaard gemaakt in de map Concepten in uw basismap. Wanneer nieuwe query's worden opgeslagen of een andere naam hebben gekregen, worden ze verwijderd uit Concepten.

Query's uitvoeren op gegevensbronnen

U kunt een querybron identificeren met behulp van een volledig gekwalificeerde tabelnaam in de query zelf of door een combinatie van catalogus en schema te selecteren in de vervolgkeuzelijsten, samen met de tabelnaam in de query. Een volledig gekwalificeerde tabelnaam in de query overschrijft de catalogus- en schemaselectors in de SQL-editor. Als een tabel- of kolomnaam spaties bevat, verpakt u deze id's in backticks in uw SQL-query's.

In de volgende voorbeelden ziet u hoe u query's kunt uitvoeren op verschillende tabelachtige objecten die u in een catalogus kunt opslaan.

Een query uitvoeren op een standaardtabel of -weergave

In het volgende voorbeeld wordt een query uitgevoerd op een tabel uit de samples catalogus.

SELECT
  o_orderdate,
  o_orderkey,
  o_custkey,
  o_totalprice,
  o_shippriority
FROM
  samples.tpch.orders

Een query uitvoeren op een metrische weergave

In het volgende voorbeeld wordt een query uitgevoerd op een metrische weergave die gebruikmaakt van een tabel uit de voorbeeldcatalogus als bron. Het evalueert de drie vermelde metingen en aggregaties over Order Month en Order Status. Het retourneert resultaten gesorteerd op Order Month. Zie Een metrische weergave maken om een vergelijkbare metrische weergave in uw werkruimte te maken.

Alle metingsevaluaties moeten worden verpakt in de MEASURE functie. Zie measure aggregatiefunctie.

SELECT
 `Order Month`,
 `Order Status`,
 MEASURE(`Order Count`),
 MEASURE(`Total Revenue`),
 MEASURE(`Total Revenue per Customer`)
FROM
 orders_metric_view
GROUP BY ALL
ORDER BY 1 ASC;

Een query optimaliseren met Databricks Assistant

Klik op het aan de rechterkant van de editor om inline hulp en suggesties te krijgen bij het schrijven van query's. De /optimize slash-opdracht vraagt de Assistant om query's te evalueren en te optimaliseren. Zie Python-, PySpark- en SQL-code optimaliseren voor meer informatie.

Meerdere querytabbladen bewerken

De SQL-editor maakt standaard gebruik van tabbladen, zodat u meerdere query's tegelijk kunt openen en bewerken. Als u een nieuw tabblad wilt openen, klikt u op +en selecteert u vervolgens Nieuwe query maken of Bestaande queryopenen. Klik op Bestaande query openen om een lijst met query's weer te geven. Het tabblad Voor u biedt een samengestelde lijst met sugesties op basis van uw gebruik. Gebruik het tabblad Alles om een query te vinden waartoe u toegang hebt.

Een enkele query of queries met meerdere instructies uitvoeren

U kunt query's met meerdere instructies schrijven naar één editortabblad. Als u meerdere queryinstructies op één tabblad wilt gebruiken, beëindigt u elke instructie met een puntkomma (;).

Eén query uitvoeren:

1. Selecteer een SQL-warehouse.
2. Markeer een query in de SQL-editor (als er meerdere query's zich in het queryvenster bevinden).
3. Druk op Ctrl/Cmd + Enter of klik op Uitvoeren (1000) om de resultaten weer te geven als een tabel in het resultatenvenster.

Notitie

Standaard zijn alle instructies uitvoeren en Limiet 1000 geselecteerd.

• Als u alleen de actieve instructie wilt uitvoeren, schakelt u de selectie Alle instructies uitvoeren uit.
• Als een query wordt opgeslagen met de instelling Limiet 1000 , is deze instelling van toepassing op alle queryuitvoeringen. Als u alle rijen (maximaal 64.000) wilt retourneren, schakelt u de selectie LIMIT van 1000 uit de vervolgkeuzelijst Uitvoeren (1000) uit. Als u een andere limiet wilt opgeven voor het aantal rijen, voegt u een LIMIT component toe aan uw query. Het maximum aantal rijen dat wordt geretourneerd in een tabel is 64.000.

Een query beëindigen

Als u een query wilt beëindigen terwijl deze wordt uitgevoerd, klikt u op Annuleren. Een beheerder kan een actieve query stoppen die een andere gebruiker heeft gestart door de uitvoerquery Beëindigen te bekijken.

Een query delen

De nieuwe SQL-editor verwerkt machtigingen in twee delen:

interactieve uitvoering: query's in de nieuwe SQL-editor worden altijd uitgevoerd met Uitvoeren als kijker machtigingen. Queryresultaten zijn toegankelijk voor iedereen die toegang heeft tot de query. Gebruikers met CAN EDIT-machtigingen of hoger kunnen het concept van de gedeelde query wijzigen. Daarnaast zijn niet-opgeslagen bewerkingen zichtbaar voor iedereen met CAN VIEW-machtigingen of hoger. Gebruikers moeten ten minste de machtiging CAN USE hebben voor het bijbehorende magazijn om query's uit te voeren.

Referentie-instellingen: De machtigingsinstellingen voor verouderde waarschuwingen, werkstromen en verouderde dashboards zijn hetzelfde als die voor de verouderde SQL-editor. Afhankelijk van uw voorkeuren kunnen deze assets worden uitgevoerd met de referenties van de eigenaar of de viewer.

Zie Querymachtigingen configureren voor meer informatie over referenties voor Uitvoeren als-eigenaar en Uitvoeren als viewer. Zie Query-ACL's voor meer informatie over het beheren van de toegang tot het queryobject.

In realtime samenwerken aan query's

Nadat u de query hebt gedeeld, kunt u query's cocreatie of foutopsporingsquery's live uitvoeren door samen te werken. Editors kunnen ook commentaar toevoegen aan afzonderlijke regels code om vragen te stellen of suggesties toe te voegen.

een query broncodebeheer

Databricks SQL-querybestanden (extensie: .dbquery.ipynb) worden ondersteund in Databricks Git-mappen. U kunt een Git-map gebruiken om uw querybestanden te beheren en deze te delen in andere werkruimten met Git-mappen die toegang hebben tot dezelfde Git-opslagplaats. Als u ervoor kiest om niet de nieuwe SQL-editor te gebruiken nadat u een query heeft doorgevoerd of gekloond in een Databricks Git-map, verwijdert u die Git-map en kloont u deze opnieuw om onverwacht gedrag te voorkomen.

Een query opslaan

Query-inhoud in de nieuwe SQL-editor wordt continu automatisch opgeslagen. Met de knop Opslaan bepaalt u of de conceptquery-inhoud moet worden toegepast op gerelateerde assets, zoals verouderde dashboards, werkstromen of verouderde waarschuwingen. Als de query wordt gedeeld met de referenties uitvoeren als eigenaar , kan alleen de eigenaar van de query de knop Opslaan gebruiken om wijzigingen door te geven. Als de referentie is ingesteld op Uitvoeren als viewer, kan elke gebruiker met ten minste CAN MANAGE machtigingen de query opslaan.

Queryresultaten weergeven

U kunt de uitvoer van elke instructie vergelijken met meerdere resultaatinstructies. Wanneer u meerdere SQL-instructies uitvoert vanuit één bewerkingsvenster, kunt u de gebruikersinterface in het deelvenster Uitvoer onderaan het scherm gebruiken om door de verschillende resultatensets te bladeren.

U kunt uw queryresultaten gebruiken en verkennen met behulp van het resultaatvenster. Het resultaatvenster bevat de volgende functies voor het verkennen van resultaten.

Visualisaties

Klik op het om een visualisatie toe te voegen. Visualisaties kunnen helpen bij het verkennen van de resultatenset. Zie visualisatietypen voor een volledige lijst met beschikbare visualisatietypen.

Klik op de op een visualisatietabblad om extra opties weer te geven.

• Klik op Downloaden om de gegevens in de visualisatie te downloaden als csv-, TSV- of Excel-bestand.
• Klik op Verwijderen om de visualisatie te verwijderen.
• Klik op Dupliceren om het tabblad Met resultaten te klonen.
• Klik op Naam wijzigen om de visualisatie een nieuwe titel te geven.

1. Klik op Bewerken om de visualisatie te bewerken.

2. Klik op Toevoegen aan dashboard om de query en visualisatie naar een nieuw AI/BI-dashboard te kopiëren.

3. Selecteer Nieuw dashboard maken of Toevoegen aan bestaand dashboard.

   • Nieuw dashboard maken: Hiermee maakt u een nieuw dashboard met alle visualisaties die aan de query zijn gekoppeld. U wordt gevraagd een naam voor het nieuwe dashboard te kiezen. Het nieuwe dashboard wordt opgeslagen in uw basismap.
   • Toevoegen aan bestaand dashboard: Voegt uw query en bijbehorende visualisaties toe aan een bestaand dashboard. Gebruik de vervolgkeuzelijst om het dashboard te kiezen waaraan de gegevensset en visualisatie moeten worden toegevoegd.

Resultaten downloaden

U kunt resultaten downloaden als csv- of Excel-bestand. CSV-downloads ondersteunen maximaal 5 GB aan gegevens. Klik op op een resultatentabblad om downloadopties weer te geven. De uiteindelijke downloadgrootte van bestanden kan iets meer of minder dan 5 GB zijn, omdat de limiet van 5 GB wordt toegepast op een eerdere stap dan de uiteindelijke download van het bestand.

Notitie

Als u een query niet kunt downloaden, heeft de beheerder van de werkruimte de download voor uw werkruimte uitgeschakeld.

Filteren

Met filters kunt u de resultatenset beperken nadat een query is uitgevoerd. U kunt filters toepassen om selectief verschillende subsets van de gegevens weer te geven. Gebruik de assistent om een filter voor resultaten toe te voegen.

Een filter toevoegen:

1. Klik op Het filterpictogram.
2. Voer tekst in om het type filter te beschrijven dat u wilt toepassen. Er wordt een benoemd filter toegepast op de resultatenset.

Een filter bewerken:

1. Klik op de naam van het filter.
2. Gebruik de vervolgkeuzelijsten en tekstvelden om de filterinstellingen aan te passen.
3. (Optioneel) Selecteer Case senstitive om de filtercase gevoelig te maken.
4. (Optioneel) Klik op OR-voorwaarde toevoegen om een extra filter toe te voegen.

Parameters toevoegen

Met parameters kunt u de resultatenset beperken door waarden in een query tijdens runtime te vervangen. Zie Werken met queryparameters voor meer informatie over het toepassen van parameters.

Wijzigingen in parametersyntaxis

Query's die zijn geschreven in de verouderde SQL-editor die dubbele accolades ({{}}) gebruiken om parameters te markeren, moeten worden gewijzigd om te worden uitgevoerd in de nieuwe SQL-editor. De nieuwe SQL-editor gebruikt dezelfde parametersyntaxis als andere Databricks-hulpprogramma's, zoals AI/BI-dashboards, AI/BI Genie en notebooks.

Parameters in de nieuwe SQL-editor worden gedefinieerd met behulp van de benoemde parametersyntaxis. Benoemde parameters zijn parameters in een query die voorafgegaan worden door een dubbele punt, bijvoorbeeld :parameter_name.

Zie benoemde parametermarkeringen voor de documentatie voor SQL-referenece. Zie voorbeelden van benoemde parametersyntaxis voor voorbeelden van het converteren van parametersyntaxis uit de klassieke SQL-editor naar benoemde parametermarkeringen.

Ondersteunde typen fiilter

In de volgende tabel ziet u filtertypen die worden ondersteund in de nieuwe SQL-editor. De tweede kolom geeft aan of het filter ook werkt in de verouderde SQL-editor.

Filtertype	Ondersteund in verouderde editor
Is gelijk aan	Ja
Is niet gelijk aan	Nee.
Is een van	Ja
Is geen van	Nee.
Bevat	Ja
Bevat geen	Nee.
Begint met	Ja
Begint niet met	Nee.
Eindigt met	Nee.
Eindigt niet met	Nee.
Is nul	Nee.
is niet null	Nee.
Groter dan	Nee.
Groter dan of gelijk aan	Nee.
Kleiner dan	Nee.
Kleiner dan of gelijk aan	Nee.
Tussen	Ja
Voordat	Nee.
Na	Nee.
Is waar	Ja
Is onwaar	Ja
OF voorwaarden	Nee.

Sneltoetsen gebruiken

De nieuwe SQL-editor bevat veel ingebouwde sneltoetsen waarmee u snel kunt werken. In de volgende tabel worden veelgebruikte sneltoetsen geïdentificeerd.

Functie	macOS-snelkoppeling	Windows-snelkoppeling
Een query uitvoeren	Cmd + Enter	Ctrl + Enter
Eén gemarkeerde instructie uitvoeren	Cmd + Shift + Enter	Ctrl + Shift + Enter
Automatisch aanvullen	Ctrl + Space	Ctrl + Space
Tekengrootte vergroten	Option + + (plusknop)	Alt + + (plusknop)
Tekengrootte verkleinen	Option + - (minteken)	Alt + - (minteken)
SQL-code opmaken	Cmd + Shift + F	Ctrl + Shift + F
Alle sneltoetsen weergeven	Esc dan H	Esc dan H

De nieuwe SQL-editor uitschakelen

Gebruik de volgende stappen om de nieuwe SQL-editor uit te schakelen:

• Klik op Nieuwe SQL-editor: AAN. Er wordt een pop-overmenu voor een nieuwe SQL-editor geopend.
• Stel de wisselknop Nieuwe SQL Editor in op UIT.
• Kies in het bevestigingsvenster ervoor om de nieuwe editor alleen uit te schakelen voor de actieve query of voor alle in aanmerking komende query's.
  • De optie Uitschakelen voor alle in aanmerking komende query's is niet geselecteerd. Behoud deze instelling als u de nieuwe editor alleen voor de actieve query wilt uitschakelen.
  • Als u de nieuwe SQL-editor voor al uw query's wilt uitschakelen, schakelt u het selectievakje in Uitschakelen voor alle in aanmerking komende query's.

Werkruimtebeheerders kunnen de preview op werkruimteniveau uitschakelen door naar de preview-portal te gaan. Zie Azure Databricks Previews beheren.