共用方式為


適用於 Azure SQL 資料庫的 Azure 入口網站查詢編輯器

適用於:Azure SQL 資料庫

查詢編輯器 (預覽版) 是在 Azure 入口網站瀏覽器中針對 Azure SQL 資料庫執行 SQL 查詢的工具。

從 Azure 入口網站查詢您的 Azure SQL 資料庫

查詢編輯器是針對 Azure SQL 資料庫中的輕量型查詢和物件探索所設計,全都來自 Azure 入口網站中的瀏覽器。 您可以對資料庫執行 T-SQL 查詢,以及在內建表格式 資料編輯器中編輯資料。

類似於 SQL Server Management Studio 中的查詢體驗,針對簡單查詢或較大的 T-SQL 查詢使用查詢編輯器。 您可以執行資料操作語言 (DML) 和資料定義語言 (Data Definition Language,DDL) 查詢。

提示

不熟悉 Azure SQL 資料庫? 快速深入了解免費訓練內容:Azure SQL 基本概念

透過查詢編輯器進行連線

查詢編輯器有兩個驗證選項:SQL 驗證或使用 Microsoft Entra ID (先前稱為 Azure Active Directory) 的驗證。

對 Azure SQL 資料庫的驗證

如需範例,請參閱快速入門:使用 Azure 入口網站查詢編輯器 (預覽版) 來查詢 Azure SQL 資料庫

  • 若要使用 SQL 驗證,透過查詢編輯器連線到 Azure SQL 資料庫,您必須擁有邏輯伺服器 master 資料庫中的登入,或所需使用者資料庫中所包含的 SQL 使用者。 如需詳細資訊,請參閱登入
    • 輸入您的使用者名稱和密碼,然後選取 [確定]。
  • 若要使用 Microsoft Entra 驗證透過查詢編輯器連線到 Azure SQL 資料庫,您的資料庫必須設定 Microsoft Entra 驗證,而且您必須在資料庫中建立 Microsoft Entra 使用者
    • 選取 [以 <user@domain> 繼續]

要存取查詢編輯器所需的權限

使用者至少需要有 Azure 角色型存取控制 (RBAC) 權限中的伺服器和資料庫的讀取權限,才能使用查詢編輯器。

查詢編輯器有四個主要區段:

  • 導覽列

  • 物件總管

  • 查詢視窗

  • Copilot for Azure SQL Database

    顯示紅色矩形的 Azure 入口網站的螢幕擷取畫面,其中醒目提示主功能表中的 [查詢編輯器] 和 [導覽列]、[物件總管] 和 [查詢視窗]。

您可以在導覽列中執行四項工作。

  • 您可以使用 [登入] 來變更驗證內容。
  • 您可以使用 [新建查詢] 來開啟空白查詢視窗。
  • 您可以使用 [開啟查詢],從本機電腦選取最多 10 個 .sql.txt 檔案,並在查詢視窗中開啟這些檔案。
  • 您可以在 Azure SQL Database 查詢編輯器上提供意見反應

物件總管

物件總管可讓您針對資料庫的資料表、檢視和預存程序檢視和執行工作。

  • 展開 [資料表] 以檢視資料庫中的資料表清單。 展開資料表,以查看資料表中的資料行。 使用省略號以選取前 1,000 個資料列、存取資料編輯器,或重新命名資料表。 如果您重新命名了資料表,請使用重新整理箭號來查看變更。
  • 展開 [檢視] 以檢視資料庫中的檢視清單。 展開檢視以便查看檢視中的資料行。 使用省略號以選取前 1,000 個資料列,或重新命名檢視。 如果您重新命名了檢視,請使用重新整理箭號來查看變更。
  • 展開 [預存程序] 以檢視資料庫中所有預存程序的清單。 展開預存程序以查看其輸出。 使用省略號在查詢視窗中檢視預存程序的定義。

查詢視窗

此視窗可讓您輸入或貼上查詢,然後執行查詢。 查詢的結果會顯示在 [結果] 窗格中。

您可以取消查詢。 如考量與限制中所述,五分鐘後就會逾時。

[儲存查詢] 按鈕可讓您將查詢文字以 .sql 檔的格式儲存到電腦上。

[將資料匯出為] 按鈕可讓您將查詢結果,以 .json.csv.xml 檔案的格式匯出到電腦上。

查詢執行時間 (或錯誤) 會顯示在狀態列中。

Azure SQL 資料庫中的 Microsoft Copilot 技能(預覽版)

Microsoft Copilot 是一種 AI 助理,其設計目的是簡化 Azure SQL 資料庫驅動應用程式的設計、作業、最佳化和健康情況。 它藉由為資料庫管理提供自然語言到 SQL 轉換和自助服務,來提高 Azure 入口網站的生產力。

自然語言到 SQL 轉換:這項體驗在適用於 Azure SQL 資料庫的 Azure 入口網站查詢編輯器中,它會將自然語言查詢轉譯成 SQL,讓資料庫互動更直覺化。

如需自然語言轉換為 SQL 功能的教學課程和範例,請參閱在 Azure 入口網站查詢編輯器中將自然語言轉換為 SQL(預覽版)。 如需詳細資訊,請參閱 Azure SQL 資料庫中的 Microsoft Copilot 技能(預覽版)的常見問題

資料編輯器

資料編輯器可讓您修改現有資料列中的資料、將資料列新增到資料表中,或刪除資料列。 這類似於 SQL Server Management Studio (SSMS) 中的體驗。

若要存取資料編輯器,請在物件總管中展開 [資料表],然後選取資料表名稱右邊的省略號,然後選取 [編輯資料 (預覽版)]。

若要修改現有資料列中的資料,請選取您要變更的值、進行變更,然後選取頂端的 [儲存]

  • 如果資料行是識別欄位,則無法在該值。 您將會看到錯誤訊息:Save failed: Failed to execute query. Error: Cannot update identity column *column_name*

若要新增資料列,請選取 [建立新資料列],然後輸入您要新增的值。 您無法在此內容中新增或使用某些資料類型。

  • 如果資料行是識別欄位,則無法在該欄位中新增值。 您將會看到錯誤訊息:Save failed: Cannot set value in identity columns *column_name*
  • 不接受具有預設限制式的資料行。 資料編輯器不會產生預設值,而會預期您輸入值。 不建議針對具有預設資料行限制式的資料表使用資料編輯器。
  • 系統不會對計算資料行進行計算。 您將會看到錯誤訊息 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.,不建議針對具有計算資料行的資料表使用資料編輯器。

若要刪除資料列,請選取資料列,然後選取 [刪除資料列]

  • 如果資料列有主索引鍵,且主索引鍵與其他資料表有外部索引鍵關聯性,則刪除此資料列時,另一個資料表中相關的資料列也會隨之刪除。

考量與限制

使用 Azure 入口網站查詢編輯器連線和查詢 Azure SQL 資料庫時,有下列考量與限制。

查詢編輯器限制

  • 如果您的查詢中有多個陳述式,只有最後一個陳述式的結果會顯示在 [結果] 索引標籤中。
  • 查詢編輯器不支援連線到邏輯伺服器的 master 資料庫。 若要連線到 master 資料庫,請使用其他工具來查詢 Azure SQL 資料庫
  • 查詢編輯器無法使用 ApplicationIntent=ReadOnly 連線到複本資料庫。 若要以這種方式連線,請改用 SSMS,並在連線選項的 [其他連線參數] 索引標籤上指定 ApplicationIntent=ReadOnly。 如需詳細資訊,請參閱連線到唯讀複本
  • 查詢編輯器在執行查詢時,超過 5 分鐘後就會逾時。 若要執行較長的查詢,請使用其他工具來查詢 Azure SQL 資料庫
  • 查詢編輯器僅支援地理資料類型的圓柱形投影。
  • 查詢編輯器不支援資料庫資料表和檢視的 IntelliSense,但可支援已輸入名稱的自動完成功能。 針對 IntelliSense 支援,請使用其他工具來查詢 Azure SQL 資料庫
  • F5 會重新整理查詢編輯器頁面,而目前在編輯器中的任何查詢都不會儲存。

查詢 Azure SQL 資料庫的其他方式

除了適用於 Azure SQL 資料庫的 Azure 入口網站查詢編輯器之外,請考慮下列其他工具的快速入門:

連線考量

  • 如果是透過公用連線來連線到查詢編輯器,您必須在伺服器允許的防火牆規則中,新增輸出 IP 位址,以存取您的資料庫。
    • 如果您已在伺服器上設定了 Private Link 連線,並從私人虛擬網路內連線到伺服器,則不需要將 IP 位址新增到 SQL 伺服器防火牆規則中。

連線錯誤的疑難排解

  • 如果您看到錯誤訊息 The X-CSRF-Signature header could not be validated,則請採取下列動作來解決問題:

    • 確定您的電腦時鐘已設為正確的時間和時區。 您可以試著搜尋資料庫位置所在的時區 (例如美國東部),讓電腦的時區與 Azure 的時區相符。
    • 如果您使用的是 Proxy 網路,請確定要求標頭 X-CSRF-Signature 未經修改或卸除。
  • 如果您的資料庫是無伺服器,則會看到錯誤訊息: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* 這表示您的無伺服器資料庫目前已暫停。 如果發生這種情況,請選取 Continue as <user@domain>,將要求傳送到資料庫以繼續。 等候大約一分鐘、重新整理頁面,然後再試一次。

  • 如果您看到錯誤訊息「使用者 <token-identified principal> 登入失敗。 伺服器目前未設定為接受此權杖。」當您嘗試使用 AD 驗證時,您的使用者會無法存取資料庫。

連接埠 443 和 1443 連線能力

您可能會在查詢編輯器中碰到下列其中一個錯誤:

  • 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.

會發生這些錯誤,是因為查詢編輯器無法透過連接埠 443 和 1443 進行通訊。 您需要已在這些連接埠上啟用輸出 HTTPS 流量。 下列指示會根據您的作業系統,逐步引導您完成此程序。 可能會需要請公司的 IT 部門核准您開啟區域網路連線。

在 Windows Defender 防火牆中允許 443 和 1443

  1. 開啟 [Windows Defender 防火牆]。
  2. 在左側功能表中,選取 [進階設定]。
  3. 在 [具有進階安全性的 Windows Defender 防火牆] 中,選取左側功能表上的 [輸出規則]。
  4. 在右側功能表上,選取 [新建規則]。
  5. 在 [新建輸出規則精靈] 中,依照下列步驟操作:
    1. 選取 [連接埠] 作為要建立的規則類型,然後選取 [下一步]。
    2. 選取 [TCP]。
    3. 選取 [特定遠端連接埠],輸入 443, 1443,然後選取 [下一步]
    4. 選取 [僅允許安全連線],選取 [下一步],然後再次選取 [下一步]。
    5. 將 [網域]、[私人] 和 [公用] 全都維持選取狀態。
    6. 指定規則的名稱,例如「存取 Azure SQL 查詢編輯器」,也可以選擇性地提供說明。 然後選取 [完成]。

在 macOS 中允許 443 和 1443

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

在 Linux 中允許 443 和 1443

執行下列命令以更新 iptables

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

在 Azure VM 中允許 443 和 1443

使用 Azure VM 時,您有一個 Azure 網路安全性群組封鎖連線能力。 Azure 網路安全性群組會篩選 Azure 虛擬網路中的 Azure 資源的輸入和輸出網路流量。 您必須新增一條輸出安全性規則至網路安全性群組。 如需範例,請參閱建立安全性規則

後續步驟