Delen via


Azure portal-query-editor voor de Azure SQL Database

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.

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

U kunt zich verifiëren bij de query-editor met behulp van SQL-verificatie of Microsoft Entra-verificatie.

Verificatie voor Azure SQL Database

Voor voorbeelden, zie Quickstart: Gebruik de query-editor van Azure Portal.

  • Als u SQL-verificatie wilt gebruiken om verbinding te maken met een Azure SQL-database via de query-editor, moet u zich aanmelden bij de database van master 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 gemaakt in de database.
    • Selecteer Doorgaan als <user@domain>.

Zodra u verbinding hebt gemaakt met de queryeditor, kunt u de Explorer gebruiken om databaseobjecten of het venster Query weer te geven om T-SQL-query's uit te voeren.

Schermopname van Azure Portal met rode rechthoeken met de queryeditor in het hoofdmenu en de navigatiebalk, Explorer, werkbalk en queryvenster.

Nuttige tips:

Queryvenster

In dit queryvenster kunt u een query typen of plakken en deze uitvoeren. In het deelvenster Resultaten worden de queryresultaten weergegeven.

  • Er is een time-out van vijf minuten voor query's.
  • Gebruik de knoppen Downloaden als om de queryresultaten te exporteren naar uw computer als een.csv, .jsonof .xlsx bestand.
  • De statusbalk toont de uitvoeringstijd van de query of eventuele fouten.
  • U kunt de resultatensets kopiëren of filteren op de werkbalk Resultaten .

Overwegingen en beperkingen

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

Beperkingen van queryeditor

  • Als uw query meerdere instructies bevat, worden op het tabblad Resultaten alleen de resultaten van de laatste instructie weergegeven.
  • 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 SQL Server Management Studio (SSMS) of de mssql-extensie voor Visual Studio Code.
  • De queryeditor kan geen verbinding maken met een replicadatabase met behulp van 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 replica voor meer informatie.
  • De queryeditor heeft een time-out van vijf minuten voor het uitvoeren van query's. Als u langere query's wilt uitvoeren, gebruikt u SQL Server Management Studio (SSMS) of de mssql-extensie voor Visual Studio Code.
  • De query-editor ondersteunt alleen cilindrische projectie voor geografiegegevenstypen.
  • De queryeditor biedt geen ondersteuning voor IntelliSense voor kolommen, maar biedt wel ondersteuning voor tabellen en weergaven. Voor volledige Ondersteuning voor IntelliSense gebruikt u SQL Server Management Studio (SSMS) of de mssql-extensie voor Visual Studio Code.
  • Terwijl u zich in dezelfde browsersessie bevindt, kunt u vrij navigeren in Azure Portal en blijven uw query's behouden. Als u de pagina vernieuwt (door op F5 te drukken) of uw browser sluit, gaan uw query's verloren.

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 foutbericht geeft aan dat uw serverloze database momenteel is onderbroken. Als dit foutbericht wordt weergegeven, verzendt het selecteren 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 de foutmelding ziet '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-connectiviteit

Vanaf maart 2026 gebruikt de Azure SQL-query-editor alleen TCP-poort 443.

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 moet communiceren via poort 443, maar dit niet kan. U moet uitgaand HTTPS-verkeer op deze poort 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.

443 toestaan 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 443in 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 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 toestaan in Linux

Voer deze opdrachten uit om iptablesbij te werken:

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

443 toestaan in Azure VM

Wanneer u Virtuele Azure-machines gebruikt, blokkeert een Azure-netwerkbeveiligingsgroep de connectiviteit. 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