Quickstart: De Query-editor (preview) van de Azure Portal gebruiken om een query uit te voeren op Azure SQL Database

VAN TOEPASSING OP: Azure SQL Database

De Query-editor is een hulpprogramma in de Azure-portal voor het uitvoeren van SQL-query's op uw database in Azure SQL Database of uw datawarehouse in Azure Synapse Analytics.

In deze snelstart gebruikt u de Query-editor om Transact-SQL-query's (T-SQL) uit te voeren op een database.

Vereisten

Een database maken met voorbeeldgegevens

Voor het voltooien van deze snelstart is de voorbeelddatabase AdventureWorksLT vereist. Als u geen werkende kopie van de AdventureWorksLT-voorbeelddatabase in SQL Database hebt, kunt u met de volgende quickstart snel een kopie maken:

Snelstart: Maak een afzonderlijke Azure SQL Database met de Azure Portal, PowerShell of Azure CLI

Een Azure Active Directory voor de server instellen (optioneel)

Als u een Azure Active Directory-beheerder (Azure AD) instelt, kunt u gebruikmaken van één identiteit om u aan te melden bij de Azure Portal en uw database. Als u Azure AD wilt gebruiken om verbinding te maken met de queryeditor, volgt u de onderstaande stappen.

Dit proces is optioneel. U kunt in plaats daarvan SQL gebruiken om verbinding te maken met de queryeditor.

1. Navigeer in Azure Portal databaseserver naar SQL databaseserver.

2. Selecteer in het menu SQL-server de optie Active Directory-beheerder.

3. Selecteer op SQL Server pagina Active Directory-beheerder de optie Beheerder instellen.

   

4. Voer op de pagina Beheerder toevoegen in het zoekvak een gebruiker of groep in die u wilt zoeken, selecteer deze als beheerder en klik vervolgens op de knop Selecteren.

5. Selecteer op de paginawerkbalk SQL Server Active Directory-beheerder Opslaan.

Query SQL editor gebruiken

1. Meld u aan bij de Azure portal en selecteer de database waarvoor u een query wilt uitvoeren.

2. Selecteer in het menu SQL database Query-editor (preview) .

   

Verbinding met de database tot stand brengen

Zelfs al bent u aangemeld bij de portal, moet u nog steeds referenties opgeven voor toegang tot de database. U kunt verbinding maken met behulp van SQL-verificatie of Azure Active Directory om verbinding te maken met uw database.

Verbinding maken met behulp van SQL-verificatie

1. Voer op de pagina Aanmeldings onder SQL Server-verificatie een Aanmelding en Wachtwoord in voor een gebruiker die toegang heeft tot de database. Als u niet zeker bent, gebruikt u de aanmelding en het wachtwoord voor de Serverbeheerder van de server van de database.

   

2. Selecteer OK.

Verbinding maken met Azure Active Directory

Bekijk in de Query-editor (preview) de pagina Aanmelding in de sectie Active Directory-verificatie. Verificatie wordt automatisch uitgevoerd, dus als u een Azure AD-beheerder voor de database bent, wordt er een bericht weergegeven met de melding dat u bent aangemeld. Selecteer vervolgens de knop Doorgaan als. <your user or group ID> Als de pagina aangeeft dat u niet bent aangemeld, moet u de pagina mogelijk vernieuwen.

Een query uitvoeren op een database in SQL Database

De volgende voorbeeld query's moeten worden uitgevoerd op basis van de voorbeelddatabase AdventureWorksLT.

Een query SELECT uitvoeren

1. Plak de volgende query in de Query-editor:

    SELECT TOP 20 pc.Name as CategoryName, p.name as ProductName
    FROM SalesLT.ProductCategory pc
    JOIN SalesLT.Product p
    ON pc.productcategoryid = p.productcategoryid;
   

2. Selecteer Uitvoeren en bekijk de uitvoer in het deelvenster Resultaten.

   

3. U kunt de query ook opslaan als een .sql-bestand of de geretourneerde gegevens exporteren als een .json-, csv- of xml-bestand.

Een query INSERT uitvoeren

Voer de volgende T-SQL-instructie INSERT uit om een nieuw product toe in de SalesLT.Producttabel toe te voegen.

1. Vervang de vorige query door deze.

   INSERT INTO [SalesLT].[Product]
          ( [Name]
          , [ProductNumber]
          , [Color]
          , [ProductCategoryID]
          , [StandardCost]
          , [ListPrice]
          , [SellStartDate]
          )
   VALUES
          ('myNewProduct'
          ,123456789
          ,'NewColor'
          ,1
          ,100
          ,100
          ,GETDATE() );
   

2. Selecteer Uitvoeren om een nieuwe rij in te voegen in de tabel Product. Het deelvenster Berichten toont Query voltooid: Betroffen rijen: 1.

Een query UPDATE uitvoeren

Voer de volgende T-SQL-instructie UPDATE uit om uw nieuwe product te wijzigen.

1. Vervang de vorige query door deze.

   UPDATE [SalesLT].[Product]
   SET [ListPrice] = 125
   WHERE Name = 'myNewProduct';
   

2. Selecteer Uitvoeren om de opgegeven rij in de tabel Product bij te werken. Het deelvenster Berichten toont Query voltooid: Betroffen rijen: 1.

Een query DELETE uitvoeren

Gebruik de volgende T-SQL-instructie DELETE uit om uw nieuwe product te verwijderen.

1. Vervang de vorige query door deze:

   DELETE FROM [SalesLT].[Product]
   WHERE Name = 'myNewProduct';
   

2. Selecteer Uitvoeren om de opgegeven rij in de tabel Product te verwijderen. Het deelvenster Berichten toont Query voltooid: Betroffen rijen: 1.

Probleemoplossing en aandachtspunten

U moet enkele dingen weten voordat u met de queryeditor gaat werken.

Instellingen voor lokaal netwerk configureren

Als u een van de volgende fouten in de queryeditor krijgt:

• Uw lokale netwerkinstellingen verhinderen mogelijk dat de Query-editor query's kan uitvoeren. Klik hier voor instructies over het configureren van uw netwerkinstellingen
• Er kan geen verbinding met de server tot stand worden gebracht. Dit kan wijzen op een probleem met uw lokale firewallconfiguratie of de instellingen van uw netwerkproxy

Dit komt doordat de queryeditor poort 443 en 1443 gebruikt om te communiceren. U moet ervoor zorgen dat u uitgaand HTTPS-verkeer op deze poorten hebt ingeschakeld. In de onderstaande instructies wordt beschreven hoe u dit doet, afhankelijk van uw besturingssysteem. Mogelijk moet u samenwerken met uw zakelijke IT om goedkeuring te verlenen voor het openen van deze verbinding in uw lokale netwerk.

Stappen voor Windows

1. Firewall Windows Defender openen
2. Selecteer geavanceerde instellingen in het menu aan de linkerkant
3. In Windows Defender Firewall met geavanceerde beveiliging selecteert u Uitgaande regels in het menu aan de linkerkant.
4. Selecteer Nieuwe regel... in het menu aan de rechterkant

Volg deze stappen in de wizard Nieuwe uitgaande regel:

1. Selecteer poort als het type regel dat u wilt maken. Selecteer Volgende
2. Selecteer TCP
3. Selecteer Specifieke externe poorten en voer '443, 1443' in. Selecteer vervolgens Volgende
4. Selecteer 'De verbinding toestaan als deze veilig is'
5. Selecteer Volgende en selecteer vervolgens opnieuw Volgende
6. Houd 'Domein', 'Privé' en 'Openbaar' allemaal geselecteerd
7. Geef de regel een naam, bijvoorbeeld Toegang tot Azure SQL queryeditor' en eventueel een beschrijving. Selecteer vervolgens Voltooien

Stappen voor Mac

1. Open Systeemvoorkeuren (Apple-menu > Systeemvoorkeuren).
2. Klik op & Privacy.
3. Klik op Firewall.
4. Als Firewall is uitgeschakeld, selecteert u Klik op de vergrendeling om onderaan wijzigingen aan te brengen en selecteert u Firewall in schakelen
5. Klik op Firewallopties.
6. Selecteer in het & Security & de volgende optie: 'Ondertekende software automatisch toestaan om binnenkomende verbindingen te ontvangen'.

Stappen voor Linux

Voer deze opdrachten uit om iptables bij te werken

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

Overwegingen bij de verbinding

• Voor openbare verbindingen met queryeditor moet u uw uitgaande IP-adres toevoegen aan de toegestane firewallregels van de server voor toegang tot uw databases en datawarehouses.

• Als u een Private Link-verbinding hebt ingesteld op de server en u verbinding maakt met de queryeditor vanuit een IP-adres in de privé-Virtual Network, werkt de Query-editor zonder dat u het IP-adres van de client hoeft toe te voegen aan de firewallregels van de SQL-databaseserver.

• De meest eenvoudige RBAC-machtigingen die nodig zijn voor het gebruik van de queryeditor zijn Leestoegang tot de server en database. Iedereen met dit toegangsniveau heeft toegang tot de functie queryeditor. Als u de toegang tot bepaalde gebruikers wilt beperken, moet u voorkomen dat ze zich kunnen aanmelden bij de query-editor met Azure Active Directory of SQL verificatiereferenties. Als ze zichzelf niet kunnen toewijzen als de AAD-beheerder voor de server of een SQL-beheerdersaccount kunnen openen/toevoegen, moeten ze geen queryeditor kunnen gebruiken.

• De query-editor biedt geen ondersteuning voor het maken van verbinding met de master-database.

• Queryeditor kan geen verbinding maken met een replicadatabase met ApplicationIntent=ReadOnly

• Als u dit foutbericht 'The X-CSRF-Signature header could not be validated' (De X-CSRF-Signature-header kan niet worden gevalideerd) ziet, moet u de volgende actie ondernemen om het probleem op te lossen:

  • Zorg ervoor dat de klok van uw computer is ingesteld op de juiste tijd en tijdzone. U kunt ook proberen de tijdzone van uw computer te matchen met Azure door te zoeken naar de tijdzone voor de locatie van uw exemplaar, zoals VS - oost, Pacific, en meer.
  • Als u zich in een proxynetwerk hebt, moet u ervoor zorgen dat de aanvraagheader 'X-CSRF-Signature' niet wordt gewijzigd of uitgevallen.

Andere overwegingen

• Wanneer u op F5 drukt, wordt de pagina van de Query-editor vernieuwd en gaan query's waaraan wordt gewerkt, verloren.

• Er is een time-out van vijf minuten voor uitvoering van de query.

• De queryeditor ondersteunt alleen cilindrische projectie voor geografiegegevenstypen.

• Er is geen ondersteuning voor IntelliSense voor databasetabellen en -weergaven, maar de editor ondersteunt wel automatisch aanvullen op namen die al zijn getypt.

Volgende stappen

Zie Transact-SQL-verschillen oplossen tijdens migratie naar SQL Database voor informatie over de Transact-SQL (T-SQL) die in Azure SQL-database wordt ondersteund.