快速入門:使用Azure 入口網站查詢編輯器 (預覽) 來查詢Azure SQL資料庫

適用于:Azure SQL資料庫

查詢編輯器 (預覽) 是一種工具,可針對Azure 入口網站中的 Azure SQL Database 執行 SQL 查詢。 在本快速入門中,您會連線到入口網站中的Azure SQL資料庫,並使用查詢編輯器來執行 Transact-SQL (T-SQL) 查詢。

先決條件

  • AdventureWorksLT 範例Azure SQL資料庫。 如果您沒有資料庫,您可以在具有 AdventureWorks 範例資料的Azure SQL Database 中建立資料庫

  • 具有連線到資料庫和查詢編輯器許可權的使用者帳戶。 您可以:

    • 擁有或設定可使用 SQL 驗證連線到資料庫的使用者。

    • 為資料庫的 SQL Server設定 Azure Active Directory (Azure AD) 系統管理員。

      Azure AD 伺服器管理員可以使用單一身分識別來登入Azure 入口網站和 SQL Server 和資料庫。 若要設定 Azure AD 伺服器管理員:

      1. [Azure 入口網站] 的 [Azure SQL資料庫概] 頁面上,選取[基本資訊] 底下的 [伺服器名稱],以流覽至您資料庫的伺服器。

      2. 在伺服器頁面上,選取左側功能表中 [設定] 區段中的[Azure Active Directory]。

      3. [Azure Active Directory ] 頁面工具列上,選取 [設定系統管理員]。

        顯示 [設定系統管理員] 選取專案的螢幕擷取畫面。

      4. [Azure Active Directory ] 表單上,搜尋並選取您想要成為系統管理員的使用者或群組,然後選取 [ 選取]。

      5. [Azure Active Directory] 主頁面上,選取 [ 儲存]。

      注意

      • Azure AD 系統管理員不支援Email位址,例如 outlook.com 或 gmail.com。 使用者必須在 Azure AD 中以原生方式建立,或同盟至 Azure AD。
      • Azure AD 系統管理員登入適用于已啟用雙因素驗證的帳戶,但查詢編輯器不支援雙因素驗證。

連線至查詢編輯器

  1. Azure 入口網站的 [SQL 資料庫概觀] 頁面上,從左側功能表中選取 [查詢編輯器] (預覽)

    顯示選取查詢編輯器的螢幕擷取畫面。

  2. 在登入畫面上,提供認證以連線到資料庫。 您可以使用 SQL 驗證或 Azure AD 進行連線。

    • 若要使用 SQL 驗證進行連線,請在 [SQL Server 驗證] 底下,輸入可存取資料庫之使用者的 [登入 ] 和 [ 密碼 ],然後選取 [ 確定]。 您一律可以使用伺服器管理員的登入和密碼。

      顯示使用 SQL 驗證登入的螢幕擷取畫面。

    • 若要使用 Azure AD 進行連線,如果您是 Azure AD 伺服器管理員,請選取 [繼續] 作為 < 使用者或群組識別碼 >。 如果登入失敗,請嘗試重新整理頁面。

查詢資料庫

[查詢編輯器 (預覽) ] 頁面上,針對您的 AdventureWorksLT 範例資料庫執行下列範例查詢。

執行 SELECT 查詢

  1. 若要查詢資料庫中的前 20 項產品,請將下列 SELECT 查詢貼到查詢編輯器中:

     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. 選取 [執行],然後檢閱 [ 結果 ] 窗格中的輸出。

    此螢幕擷取畫面顯示 SELECT 查詢的查詢編輯器結果。

  3. 您可以選擇性地選取 [ 儲存查詢 ] 將查詢儲存為 .sql 檔案,或選取 [ 匯出資料 為] 以將結果匯出為 .json.csv.xml 檔案。

執行 INSERT 查詢

若要將新產品新增至 SalesLT.Product 資料表,請執行下列 INSERT T-SQL 語句。

  1. 在查詢編輯器中,將先前的查詢取代為下列查詢:

    INSERT INTO [SalesLT].[Product]
           ( [Name]
           , [ProductNumber]
           , [Color]
           , [ProductCategoryID]
           , [StandardCost]
           , [ListPrice]
           , [SellStartDate]
           )
    VALUES
           ('myNewProduct'
           ,123456789
           ,'NewColor'
           ,1
           ,100
           ,100
           ,GETDATE() );
    
  2. 選取 [執行 ] 以新增產品。 執行查詢之後,[ 訊息 ] 窗格會顯示 [查詢成功:受影響的資料列:1]。

執行 UPDATE 查詢

執行下列 UPDATE T-SQL 語句來更新新產品的價格。

  1. 在查詢編輯器中,將先前的查詢取代為下列查詢:

    UPDATE [SalesLT].[Product]
    SET [ListPrice] = 125
    WHERE Name = 'myNewProduct';
    
  2. 選取 [執行] 以在 Product 資料表中更新指定的資料列。 [訊息] 窗格會顯示成功的查詢:受影響的資料列:1

執行 DELETE 詢

執行以下 DELETE T-SQL 陳述式移除您的新產品。

  1. 在查詢編輯器中,將先前的查詢取代為下列查詢:

    DELETE FROM [SalesLT].[Product]
    WHERE Name = 'myNewProduct';
    
  2. 選取 [執行] 以在 Product 資料表中刪除指定的資料列。 [訊息] 窗格會顯示成功的查詢:受影響的資料列:1

考量與限制

下列考慮和限制適用于使用查詢編輯器連線至資料庫並查詢Azure SQL資料庫。

查詢編輯器限制

  • 查詢編輯器不支援連接到 master 資料庫。 若要連線到 master 資料庫,請使用SQL Server Management Studio (SSMS) Visual Studio CodeAzure Data Studio
  • 查詢編輯器無法使用 連接到 複本資料庫ApplicationIntent=ReadOnly 。 若要以這種方式從豐富的用戶端連線,請使用 SSMS,並在連線選項的 [其他連線參數] 索引標籤上指定 ApplicationIntent=ReadOnly 。 如需詳細資訊,請參閱 連接到唯讀複本
  • 查詢編輯器有 5 分鐘的查詢執行逾時。 若要執行較長的查詢,請使用SSMSVisual Studio CodeAzure Data Studio
  • 查詢編輯器僅支援地理資料類型的圓柱形投影。
  • 查詢編輯器不支援資料庫資料表和檢視的 IntelliSense,但支援已輸入名稱的自動完成。 針對 IntelliSense 支援,請使用SSMSVisual Studio CodeAzure Data Studio
  • F5 會重新整理查詢編輯器頁面,而且目前在編輯器中的任何查詢都未儲存。

連線考量

  • 針對查詢編輯器的公用連線,您必須 將輸出 IP 位址新增至伺服器的允許防火牆規則 ,才能存取您的資料庫。

    如果您已在伺服器上設定Private Link連線,而且從專用虛擬網路內連線到伺服器,則不需要將 IP 位址新增至 SQL Server 防火牆規則。

  • 使用者至少需要角色型存取控制 (RBAC) 許可權讀取伺服器和資料庫的存取 權,才能使用查詢編輯器。 具有此層級存取權的任何人都可以存取查詢編輯器。 無法將自己指派為 Azure AD 系統管理員或存取 SQL 系統管理員帳戶的使用者不應該存取查詢編輯器。

連線錯誤疑難排解

  • 如果您看到錯誤訊息 X-CSRF-Signature 標頭無法驗證,請採取下列動作來解決問題:

    • 確定您的電腦時鐘已設為正確的時間和時區。 您可以搜尋資料庫位置的時區,例如美國東部,嘗試將電腦的時區與 Azure 比對。
    • 如果您是在 Proxy 網路上,請確定要求標頭 X-CSRF-Signature 未遭到修改或卸載。
  • 您可能會在查詢編輯器中收到下列其中一個錯誤:

    • 您的區域網路設定可能防止查詢編輯器發出查詢。 如需如何設定網路設定的指示,請按一下這裡。
    • 無法建立與伺服器的連線。 這可能表示您的本機防火牆設定或網路 Proxy 設定有問題。

    發生這些錯誤的原因是查詢編輯器無法透過埠 443 和 1443 進行通訊。 您必須在這些埠上啟用輸出 HTTPS 流量。 下列指示會引導您完成此程式,視您的 OS 而定。 您的公司 IT 部門可能需要授與核准,才能在您的區域網路上開啟此連線。

    若為 Windows:

    1. 開啟 [Windows Defender 防火牆]。

    2. 在左側功能表上,選取 [ 進階設定]。

    3. [Windows Defender具有進階安全性的防火牆] 中,選取左側功能表上的 [輸出規則]。

    4. 選取右側功能表上的 [ 新增規則 ]。

    5. 在 [ 新增輸出規則精靈] 中,遵循下列步驟:

      1. 選取 [埠 ] 作為您想要建立的規則類型,然後選取 [ 下一步]。
      2. 選取 [TCP]。
      3. 選取 [特定遠端埠] ,輸入 443、1443,然後選取 [ 下一步]。
      4. 選取 [允許連線是否安全],選取 [ 下一步],然後再次選取 [ 下一步 ]。
      5. 保留已選取 [網域]、 [私人] 和 [公用 ]。
      6. 為規則指定名稱,例如Access Azure SQL查詢編輯器,並選擇性地提供描述。 然後選取 [完成]。

    針對 MacOS:

    1. 在 Apple 功能表上,開啟 [系統喜好設定]。
    2. 選取 [安全性 & 隱私權],然後選取 [ 防火牆]。
    3. 如果 [防火牆 ] 關閉,請選取 [按一下鎖定] 以在底部進行變更 ,然後選取 [ 開啟防火牆]。
    4. 選取 [防火牆選項]。
    5. 在 [ 安全性 & 隱私權] 視窗中,選取 [自動允許已簽署的軟體接收連入連線]。

    若為 Linux:

    執行下列命令以更新 iptables

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

後續步驟