Snabbstart: Använd Azure Portal frågeredigeraren (förhandsversion) för att fråga en Azure SQL Database

GÄLLER FÖR: Azure SQL Database

Frågeredigeraren är ett verktyg i Azure Portal för att köra SQL frågor mot din databas i Azure SQL Database eller informationslagret i Azure Synapse Analytics.

I den här snabbstarten använder du frågeredigeraren för att köra Transact-SQL-frågor (T-SQL) mot en databas.

Förutsättningar

Skapa en databas med exempeldata

För att slutföra den här snabbstarten krävs exempeldatabasen AdventureWorksLT. Om du inte har en fungerande kopia av AdventureWorksLT-exempeldatabasen i SQL Database snabbstarten hjälper dig att snabbt skapa en:

Snabbstart: Skapa en databas i Azure SQL Database med Azure Portal, PowerShell eller Azure CLI

Ange Azure Active Directory administratör för servern (valfritt)

Genom att Azure Active Directory administratör (Azure AD) kan du använda en enda identitet för att logga in på Azure Portal och databasen. Följ stegen nedan om du vill använda Azure AD för att ansluta till frågeredigeraren.

Den här processen är valfri. Du kan i stället använda SQL för att ansluta till frågeredigeraren.

1. I Azure Portal navigerar du till SQL databasserver.

2. På menyn SQL väljer du Active Directory-administratör.

3. I verktygsfältet SQL Server Active Directory-administratör väljer du Ange administratör.

   

4. På sidan Lägg till administratör i sökrutan anger du en användare eller grupp att söka efter, väljer den som administratör och väljer sedan knappen Välj.

5. I verktygsfältet för SQL Server Active Directory-administratör väljer du Spara.

Använda SQL Frågeredigeraren

1. Logga in på Azure Portal och välj den databas som du vill fråga.

2. I menyn SQL databas väljer du Frågeredigeraren (förhandsversion).

   

Upprätta en anslutning till databasen

Även om du är inloggad på portalen måste du fortfarande ange autentiseringsuppgifter för att få åtkomst till databasen. Du kan ansluta med SQL autentisering eller Azure Active Directory ansluta till databasen.

Anslut med SQL-autentisering

1. På sidan Inloggning, under SQL serverautentisering, anger du inloggning och lösenord för en användare som har åtkomst till databasen. Om du inte är säker använder du inloggningen och lösenordet för serveradministratören för databasens server.

   

2. Välj OK.

Ansluta med Azure Active Directory

I frågeredigeraren (förhandsversion) tittar du på inloggningssidan i avsnittet Active Directory-autentisering. Autentiseringen sker automatiskt, så om du är Azure AD-administratör för databasen visas ett meddelande om att du har loggat in. Välj sedan knappen Fortsätt som. <your user or group ID> Om sidan visar att du inte har loggat in kan du behöva uppdatera sidan.

Fråga en databas i SQL Database

Följande exempelfrågor ska köras mot exempeldatabasen AdventureWorksLT.

Köra en SELECT-fråga

1. Klistra in följande fråga i frågeredigeraren:

    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. Välj Kör och granska sedan utdata i resultatfönstret.

   

3. Du kan också spara frågan som en .sql-fil eller exportera returnerade data som en .json-, .csv- eller .xml fil.

Köra en INSERT-fråga

Kör följande INSERT T-SQL för att lägga till en ny produkt i SalesLT.Product tabellen.

1. Ersätt den tidigare frågan med denna.

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

2. Välj Kör för att infoga en ny rad i tabellen Product. I fönstret Meddelanden visas Frågan lyckades: Berörda rader: 1.

Köra en UPDATE-fråga

Kör följande UPDATE T-SQL för att ändra den nya produkten.

1. Ersätt den tidigare frågan med denna.

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

2. Välj Kör för att uppdatera den angivna raden i tabellen Product. I fönstret Meddelanden visas Frågan lyckades: Berörda rader: 1.

Köra en DELETE-fråga

Kör följande DELETE T-SQL för att ta bort den nya produkten.

1. Ersätt den föregående frågan med denna:

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

2. Välj Kör för att ta bort den angivna raden i tabellen Product. I fönstret Meddelanden visas Frågan lyckades: Berörda rader: 1.

Felsökning och överväganden

Det finns några saker du behöver veta när du arbetar med frågeredigeraren.

Konfigurera inställningar för lokalt nätverk

Om du får något av följande fel i frågeredigeraren:

• Dina lokala nätverksinställningar kan hindra frågeredigeraren från att utfärda frågor. Klicka här om du vill ha anvisningar om hur du konfigurerar nätverksinställningarna
• Det gick inte att upprätta en anslutning till servern. Detta kan tyda på ett problem med konfigurationen av den lokala brandväggen eller inställningarna för nätverksproxy

Det beror på att frågeredigeraren använder port 443 och 1443 för att kommunicera. Du måste se till att du har aktiverat utgående HTTPS-trafik på dessa portar. Anvisningarna nedan visar hur du gör detta, beroende på ditt operativsystem. Du kan behöva samarbeta med företagets IT för att bevilja godkännande för att öppna den här anslutningen i ditt lokala nätverk.

Steg för Windows

1. Öppna Windows Defender-brandväggen
2. På menyn till vänster väljer du Avancerade inställningar
3. I Windows Defender Med avancerad säkerhet väljer du Utgående regler på menyn till vänster.
4. Välj Ny regel... på menyn till höger

Följ dessa steg i guiden Ny regel för utgående trafik:

1. Välj port som den typ av regel som du vill skapa. Välj Nästa
2. Välj TCP
3. Välj Specifika fjärrportar och ange "443, 1443". Välj sedan Nästa
4. Välj "Tillåt anslutningen om den är säker"
5. Välj Nästa och sedan Nästa igen
6. Behåll "Domän", "Privat" och "Offentligt" alla markerade
7. Ge regeln ett namn, till exempel "Åtkomst till Azure SQL frågeredigeraren" och eventuellt en beskrivning. Välj sedan Slutför

Steg för Mac

1. Öppna Systeminställningar (Apple-> Systeminställningar).
2. Klicka på Security & Privacy.
3. Klicka på Brandvägg.
4. Om brandväggen är inaktiverad väljer du Klicka på låset för att göra ändringar längst ned och väljer Aktivera brandvägg
5. Klicka på Brandväggsalternativ.
6. I fönstret Sekretess för & väljer du det här alternativet: "Tillåt automatiskt att signerad programvara tar emot inkommande anslutningar".

Steg för Linux

Kör dessa kommandon för att uppdatera iptables

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

Överväganden för anslutning

• För offentliga anslutningar till frågeredigeraren måste du lägga till din utgående IP-adress till serverns tillåtna brandväggsregler för att få åtkomst till dina databaser och informationslager.

• Om du har en Private Link-anslutning som har ställts in på servern och du ansluter till frågeredigeraren från en IP-adress i den privata Virtual Network fungerar frågeredigeraren utan att du behöver lägga till klientens IP-adress i brandväggsreglerna för SQL-databasservern.

• De mest grundläggande RBAC-behörigheterna som krävs för att använda frågeredigeraren är Läsåtkomst till servern och databasen. Alla med den här åtkomstnivån kan komma åt frågeredigeraren. Om du vill begränsa åtkomsten till vissa användare måste du förhindra att de kan logga in i frågeredigeraren med Azure Active Directory eller SQL autentiseringsuppgifter. Om de inte kan tilldela sig själva AAD administratör för servern eller komma åt/lägga till ett SQL-administratörskonto, bör de inte kunna använda frågeredigeraren.

• Frågeredigeraren stöder inte anslutning till databasen master.

• Frågeredigeraren kan inte ansluta till en replikdatabas med ApplicationIntent=ReadOnly

• Om du såg det här felmeddelandet "Huvudet X-CSRF-Signature kunde inte verifieras" kan du vidta följande åtgärd för att lösa problemet:

  • Kontrollera att datorns klocka är inställd på rätt tid och tidszon. Du kan också försöka matcha datorns tidszon med Azure genom att söka efter tidszonen för platsen för din instans, till exempel USA, östra, Stillahavsområdet och så vidare.
  • Om du använder ett proxynätverk kontrollerar du att begärandehuvudet "X-CSRF-Signature" inte ändras eller tas bort.

Ytterligare överväganden

• Om du trycker på F5 uppdateras frågeredigerarens sida och alla frågor som bearbetas går förlorade.

• Det finns en 5 minuters timeout för frågekörning.

• Frågeredigeraren stöder endast cylindriska projektioner för geografidatatyper.

• Det finns inget stöd för IntelliSense för databastabeller och vyer, men redigeraren stöder automatisk komplettering av namn som redan har skrivits.

Nästa steg

Mer information om transact-SQL (T-SQL) som stöds i Azure SQL Database finns i Lösa Transact-SQL skillnaderunder migrering till SQL Database .