Delen via

Azure portal-query-editor voor de Azure SQL Database

  • Artikel

van toepassing op:Azure SQL Database-

De Query-editor (preview) is een hulpprogramma voor het uitvoeren van T-SQL-query's in Azure Portal in de browser voor Azure SQL Database.

Query's uitvoeren op uw Azure SQL Database vanuit Azure Portal

De query-editor is ontworpen voor lichtgewicht query's en objectverkenning in uw Azure SQL-database, allemaal vanuit de browser in Azure Portal. U kunt T-SQL-query's uitvoeren op uw database en gegevens bewerken in de ingebouwde tabellaire gegevenseditor.

Net als bij de query-ervaring in SQL Server Management Studio gebruikt u de queryeditor voor zowel eenvoudige query's als grotere T-SQL-query's. U kunt DML-query's (Data Manipulation Language) en Data Definition Language (DDL) uitvoeren.

Tip

Nieuw bij Azure SQL Database? Ga snel aan de slag met uitgebreide gratis trainingsinhoud: Basisinformatie over Azure SQL.

Verbinding maken via de queryeditor

Er zijn twee verificatieopties voor query-editor: SQL-verificatie of -verificatie met Microsoft Entra-id (voorheen Azure Active Directory).

Verificatie voor Azure SQL Database

Zie quickstart voor voorbeelden: Query-editor (preview) van Azure Portal gebruiken om een query uit te voeren op Azure SQL Database.

  • Als u SQL-verificatie wilt gebruiken om via de queryeditor verbinding te maken met een Azure SQL-database, moet u zich aanmelden bij de master-database van de logische server of een ingesloten SQL-gebruiker in de gewenste gebruikersdatabase. Zie Aanmeldingenvoor meer informatie.
    • Voer uw gebruikersnaam en wachtwoord in en selecteer vervolgens OK.
  • Als u Microsoft Entra-verificatie wilt gebruiken om via de queryeditor verbinding te maken met een Azure SQL-database, moet uw database zijn geconfigureerd met Microsoft Entra-verificatie en moet u een Microsoft Entra-gebruiker hebben die is gemaakt in de database.
    • Selecteer Doorgaan als <user@domain>.

Vereiste machtigingen voor toegang tot de queryeditor

Gebruikers hebben ten minste de RBAC-machtiging (Op rollen gebaseerd toegangsbeheer) van Azure nodig Leestoegang tot de server en database om de queryeditor te kunnen gebruiken.

Er zijn vier hoofdsecties van de queryeditor:

  • Navigatiebalk

  • Objectverkenner

  • Queryvenster

  • Copilot voor Azure SQL Database

    Schermopname van Azure Portal met rode rechthoeken die de queryeditor markeren in het hoofdmenu en het navigatiebalkvenster, Objectverkenner en Query.

Er zijn vier taken die u kunt uitvoeren in de navigatiebalk.

  • U kunt Login gebruiken om uw authenticatiecontext te wijzigen.
  • U kunt nieuwe query gebruiken om een leeg queryvenster te openen.
  • U kunt Query openen gebruiken om maximaal 10 .sql of .txt bestanden te selecteren vanaf uw lokale computer en deze te openen in het queryvenster.
  • U kunt feedback geven in de Query-editor van Azure SQL Database.

Objectverkenner

Met objectverkenner kunt u taken weergeven en uitvoeren op basis van de tabellen, weergaven en opgeslagen procedures van uw database.

  • Vouw tabellen uit om de lijst met tabellen in uw database weer te geven. Vouw de tabel uit om de kolommen in de tabel weer te geven. Gebruik het beletselteken om de bovenste 1000 rijen te selecteren, toegang te krijgen tot de Gegevenseditorof de tabel een andere naam te geven. Als u de naam van een tabel wijzigt, gebruikt u de pijl vernieuwen om de wijzigingen te zien.
  • Uitbreid weergaven om een lijst met weergaven in uw database weer te geven. Vouw de weergave uit om de kolommen in de weergave weer te geven. Gebruik het beletselteken om de bovenste 1000 rijen te selecteren of de weergave een andere naam te geven. Als u de naam van een weergave wijzigt, gebruikt u de vernieuwingspijl om de wijzigingen te zien.
  • Vouw opgeslagen procedures uit om een lijst weer te geven met alle opgeslagen procedures in uw database. Vouw een opgeslagen procedure uit om de uitvoer van de opgeslagen procedure te bekijken. Gebruik het beletselteken om de definitie van de opgeslagen procedure in het queryvenster weer te geven.

Queryvenster

In dit venster kunt u een query typen of plakken en deze vervolgens uitvoeren. De resultaten van de query worden weergegeven in het deelvenster Resultaten.

U kunt uw query annuleren. Zoals vermeld onder Overwegingen en beperkingen, is er een time-outperiode van vijf minuten.

Met de knop Query opslaan kunt u de querytekst opslaan op uw computer als een .sql bestand.

Met de knop Gegevens exporteren als kunt u de queryresultaten als een .json, .csvof .xml bestand naar uw computer exporteren.

De uitvoeringstijd of fouten van de query worden weergegeven op de statusbalk.

Microsoft Copilot-vaardigheden in Azure SQL Database (voorvertoning)

Microsoft Copilot- is een AI-assistent die is ontworpen om het ontwerp, de werking, de optimalisatie en de status van azure SQL Database-gestuurde toepassingen te stroomlijnen. Het verbetert de productiviteit in Azure Portal door natuurlijke taal aan te bieden voor SQL-conversie en zelfhulp voor databasebeheer.

De Natuurlijke taal voor SQL ervaring in de Query-editor van Azure Portal voor Azure SQL Database vertaalt query's in natuurlijke taal in SQL, waardoor database-interacties intuïtiever worden.

Zie voor een zelfstudie en voorbeelden van natuurlijke taal voor SQL-mogelijkheden van Copilot Natuurlijke taal voor SQL in de Query-editor (preview) van Azure Portal. Zie Veelgestelde vragen over Microsoft Copilot-vaardigheden in Azure SQL Database (preview)voor meer informatie.

Gegevenseditor

Met de gegevenseditor kunt u gegevens in een bestaande rij wijzigen, een nieuwe rij met gegevens toevoegen aan de tabel of een rij met gegevens verwijderen. Dit is vergelijkbaar met de ervaring in SQL Server Management Studio (SSMS).

Als u toegang wilt krijgen tot de gegevenseditor, vouwt u in objectverkenner Tabellenuit, selecteert u het beletselteken rechts van de tabelnaam en selecteert u Gegevens bewerken (preview).

Als u gegevens in een bestaande rij wilt wijzigen, selecteert u de waarde die u wilt wijzigen, maakt u de wijziging en selecteert u vervolgens bovenaan opslaan.

  • Als de kolom een identiteitskolom is, kunt u die waarde niet bewerken. U ziet het foutbericht: Save failed: Failed to execute query. Error: Cannot update identity column *column_name*.

Als u een nieuwe rij wilt toevoegen, selecteert u Nieuwe rij maken en voert u de waarden in die u wilt toevoegen. Er zijn bepaalde gegevenstypen waarmee u in deze context geen gegevenstypen kunt toevoegen of ermee kunt werken.

  • Als de kolom een identiteitskolom is, kunt u geen waarde in dat veld toevoegen. U ziet het foutbericht: Save failed: Cannot set value in identity columns *column_name*.
  • Kolommen met standaardrestricties worden niet gerespecteerd. De gegevenseditor genereert niet de standaardwaarde, maar verwacht dat u een waarde invoert. Het is niet raadzaam om de gegevenseditor te gebruiken voor tabellen met standaardkolombeperkingen.
  • Berekende kolommen worden niet berekend. U ziet het foutbericht Save failed: Failed to execute query. Error: The column *column_name* cannot be modified because it is either a computed column or is the result of a UNION operator. Het is niet raadzaam om de gegevenseditor te gebruiken voor tabellen met berekende kolommen.

Als u een rij met gegevens wilt verwijderen, selecteert u de rij en selecteert u Rij verwijderen.

  • Als de rij een primaire sleutel heeft en die primaire sleutel een refererende sleutelrelatie heeft met een andere tabel, worden de gerelateerde rijen in de andere tabel ook verwijderd wanneer de rij wordt verwijderd.

Overwegingen en beperkingen

De volgende overwegingen en beperkingen zijn van toepassing bij het maken van verbinding met Azure SQL Database en het uitvoeren van query's op Azure Portal met de query-editor van Azure Portal.

Beperkingen van queryeditor

  • Als uw query meerdere instructies heeft, worden alleen de resultaten van de laatste instructie weergegeven op het tabblad Resultaten.
  • De query-editor biedt geen ondersteuning voor het maken van verbinding met de master database van de logische server. Als u verbinding wilt maken met de master-database, gebruikt u andere hulpprogramma's om een query uit te voeren op uw Azure SQL Database-.
  • De queryeditor kan geen verbinding maken met een replicadatabase met ApplicationIntent=ReadOnly. Als u op deze manier verbinding wilt maken, gebruikt u SSMS en geeft u ApplicationIntent=ReadOnly op op het tabblad Aanvullende verbindingsparameters in verbindingsopties. Zie Verbinding maken met een alleen-lezen replicavoor meer informatie.
  • De queryeditor heeft een time-out van 5 minuten voor het uitvoeren van query's. Als u langere query's wilt uitvoeren, gebruikt u andere hulpprogramma's om een query uit te voeren op uw Azure SQL Database-.
  • De query-editor ondersteunt alleen cilindrische projectie voor geografiegegevenstypen.
  • De queryeditor biedt geen ondersteuning voor IntelliSense voor databasetabellen en -weergaven, maar ondersteunt automatisch aanvullen voor namen die al zijn getypt. Gebruik voor IntelliSense-ondersteuning andere hulpprogramma's om een query uit te voeren op uw Azure SQL Database-.
  • Als u op F5 drukt, wordt de pagina van de queryeditor vernieuwd en worden query's die momenteel in de editor aanwezig zijn, niet opgeslagen.

Andere manieren om een query uit te voeren op uw Azure SQL Database

Naast de Query-editor van Azure Portal voor Azure SQL Database, kunt u de volgende quickstarts voor andere hulpprogramma's overwegen:

Overwegingen voor verbinding

Problemen met verbindingsfouten oplossen

  • Als u het foutbericht The X-CSRF-Signature header could not be validatedziet, voert u de volgende acties uit om het probleem op te lossen:

    • Controleer of de klok van uw computer is ingesteld op de juiste tijd en tijdzone. U kunt proberen de tijdzone van uw computer te vergelijken met Azure door te zoeken naar de tijdzone voor uw databaselocatie, zoals VS - oost.
    • Als u zich in een proxynetwerk bevindt, moet u ervoor zorgen dat de aanvraagheader X-CSRF-Signature niet wordt gewijzigd of verwijderd.

  • Als uw database serverloos is en u het foutbericht ziet: Database *name* on server *name.database.windows.net* is not currently available. Please retry the connection later. If the problem persists, contact customer support, and provide them the session tracing ID *ID* Dit geeft aan dat uw serverloze database momenteel is onderbroken. Als dit het geval is, stuurt het selecteren van Continue as <user@domain> een aanvraag naar de database om te hervatten. Wacht ongeveer één minuut, vernieuw de pagina en probeer het opnieuw.

  • Als u het foutbericht 'Aanmelden is mislukt voor gebruiker <token-identified principal>.' De server is momenteel niet geconfigureerd om dit token te accepteren. Wanneer u AD-verificatie probeert te gebruiken, heeft uw gebruiker geen toegang tot de database.

Poort 443- en 1443-connectiviteit

Mogelijk krijgt u een van de volgende fouten in de query-editor:

  • Your local network settings might be preventing the Query Editor from issuing queries. Please click here for instructions on how to configure your network settings.
  • A connection to the server could not be established. This might indicate an issue with your local firewall configuration or your network proxy settings.

Deze fouten treden op omdat de query-editor niet kan communiceren via poort 443 en 1443. U moet uitgaand HTTPS-verkeer op deze poorten inschakelen. Aan de hand van de volgende instructies doorloopt u dit proces, afhankelijk van uw besturingssysteem. Uw IT-afdeling van uw bedrijf moet mogelijk goedkeuring verlenen om deze verbinding te openen in uw lokale netwerk.

Sta poort 443 en 1443 toe in Windows Defender Firewall

  1. Open Windows Defender Firewall.
  2. Selecteer in het linkermenu Geavanceerde instellingen.
  3. Selecteer in Windows Defender Firewall met geavanceerde beveiligingde uitgaande regels in het linkermenu.
  4. Selecteer nieuwe regel in het menu aan de rechterkant.
  5. Voer in de wizard Nieuwe uitgaande regelde volgende stappen uit:
    1. Selecteer poort als het type regel dat u wilt maken en selecteer vervolgens Volgende.
    2. Selecteer TCP-.
    3. Selecteer Specifieke externe poorten, voer 443, 1443in en selecteer vervolgens Volgende.
    4. Selecteer De verbinding toestaan als deze beveiligd is, selecteer Volgendeen selecteer vervolgens opnieuw Volgende.
    5. Houd domein, privéen publiek geselecteerd.
    6. Geef de regel een naam, bijvoorbeeld Access Azure SQL-queryeditoren geef desgewenst een beschrijving op. Vervolgens selecteer voltooien.

443 en 1443 toestaan in macOS

  1. Open Systeemvoorkeurenin het Apple-menu.
  2. Selecteer Security & Privacyen selecteer Firewall.
  3. Als Firewall is uitgeschakeld, selecteert u Klik op de vergrendeling om wijzigingen aan te brengen, en selecteert u Firewall inschakelen.
  4. Selecteer firewallopties.
  5. Selecteer in het Beveiliging & Privacy venster Automatisch toestaan dat ondertekende software binnenkomende verbindingen ontvangt.

443 en 1443 toestaan in Linux

Voer deze opdrachten uit om iptablesbij te werken:

sudo iptables -A OUTPUT -p tcp --dport 443 -j ACCEPT
sudo iptables -A OUTPUT -p tcp --dport 1443 -j ACCEPT

Poorten 443 en 1443 toestaan in Azure VM

Wanneer u Azure-VM's gebruikt, hebt u een Azure-netwerkbeveiligingsgroep de connectiviteit te blokkeren. Een netwerkbeveiligingsgroep kan binnenkomend en uitgaand netwerkverkeer naar en van Azure-resources in een virtueel Azure-netwerk filteren. U moet een uitgaande beveiligingsregel toevoegen aan de netwerkbeveiligingsgroep. Zie Beveiligingsregels makenvoor een voorbeeld.

Volgende stap

Quickstart: Gebruik de query-editor van het Azure Portal om een query uit te voeren op Azure SQL Database

Verwante inhoud