適用於 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 檔案的格式匯出到電腦上。

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

Copilot for Azure SQL Database (預覽版)

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

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

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

資料編輯器

資料編輯器可讓您修改現有資料列中的資料、將資料列新增到資料表中，或刪除資料列。 這類似於 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 資源的輸入和輸出網路流量。 您必須新增一條輸出安全性規則至網路安全性群組。 如需範例，請參閱建立安全性規則。

後續步驟

快速入門：使用 Azure 入口網站查詢編輯器來查詢 Azure SQL 資料庫

相關內容