Edytor zapytań witryny Azure Portal dla usługi Azure SQL Database

Dotyczy: Azure SQL Database

Edytor zapytań (wersja zapoznawcza) to narzędzie do uruchamiania zapytań T-SQL w witrynie Azure Portal w przeglądarce względem usługi Azure SQL Database.

Wykonywanie zapytań względem usługi Azure SQL Database w witrynie Azure Portal

Edytor zapytań jest przeznaczony do uproszczonego wykonywania zapytań i eksploracji obiektów w bazie danych Azure SQL Database— wszystko to z poziomu przeglądarki w witrynie Azure Portal. Zapytania T-SQL można uruchamiać względem bazy danych, a także edytować dane w edytorze danych tabelarycznych w kompilacji.

Podobnie jak w przypadku środowiska zapytań w programie SQL Server Management Studio, użyj edytora zapytań dla zapytań prostych lub większych zapytań języka T-SQL. Zapytania języka DML (Data Manipulation Language) i języka DDL (Data Manipulation Language) można wykonywać.

Porada

Dopiero zaczynasz korzystać z usługi Azure SQL Database? Uzyskaj szybki dostęp do szczegółowej zawartości szkoleniowej: Podstawy usługi Azure SQL.

Nawiązywanie połączenia za pośrednictwem edytora zapytań

Istnieją dwie opcje uwierzytelniania dla edytora zapytań: uwierzytelnianie SQL lub uwierzytelnianie za pomocą identyfikatora Entra firmy Microsoft (dawniej Azure Active Directory).

Uwierzytelnianie w usłudze Azure SQL Database

Aby zapoznać się z przykładami, zobacz Szybki start: używanie edytora zapytań w witrynie Azure Portal (wersja zapoznawcza) do wykonywania zapytań w usłudze Azure SQL Database.

  • Aby używać uwierzytelniania SQL do nawiązywania połączenia z bazą danych Azure SQL Database za pośrednictwem edytora zapytań, musisz mieć identyfikator logowania w bazie danych serwera master logicznego lub zawartego użytkownika SQL w żądanej bazie danych użytkownika. Aby uzyskać więcej informacji, zobacz temat Logowania.
    • Wprowadź nazwę użytkownika i hasło, a następnie wybierz przycisk OK.
  • Aby użyć uwierzytelniania Microsoft Entra w celu nawiązania połączenia z bazą danych Azure SQL Database za pośrednictwem edytora zapytań, baza danych musi być skonfigurowana przy użyciu uwierzytelniania Microsoft Entra i musisz mieć użytkownika Microsoft Entra utworzonego w bazie danych.
    • Wybierz pozycję Kontynuuj jako <user@domain>.

Uprawnienia wymagane do uzyskania dostępu do edytora zapytań

Użytkownicy potrzebują co najmniej uprawnień kontroli dostępu opartej na rolach (RBAC) platformy Azure Do korzystania z edytora zapytań dostęp do serwera i bazy danych .

Istnieją cztery główne sekcje edytora zapytań:

  • Pasek nawigacyjny

  • Eksplorator obiektów

  • Okno zapytania

  • Copilot dla usługi Azure SQL Database

    Zrzut ekranu witryny Azure Portal przedstawiający czerwone prostokąty z wyróżnionymi edytorem zapytań w menu głównym i paskiem nawigacji, Eksplorator obiektów i oknem Zapytanie.

Na pasku nawigacyjnym można wykonać cztery zadania.

  • Aby zmienić kontekst uwierzytelniania, możesz użyć identyfikatora Logowania .
  • Możesz użyć nowego zapytania , aby otworzyć puste okno zapytania.
  • Możesz użyć polecenia Otwórz zapytanie , aby wybrać maksymalnie 10 .sql lub .txt pliki z komputera lokalnego i otworzyć je w oknie zapytania.
  • Możesz przekazać opinię na temat edytora zapytań usługi Azure SQL Database.

Eksplorator obiektów

Eksplorator obiektów umożliwia wyświetlanie i wykonywanie zadań względem tabel, widoków i procedur składowanych bazy danych.

  • Rozwiń węzeł Tabele , aby wyświetlić listę tabel w bazie danych. Rozwiń tabelę, aby wyświetlić kolumny w tabeli. Użyj wielokropka, aby wybrać 1000 pierwszych wierszy, uzyskać dostęp do edytora danych lub zmienić nazwę tabeli. Jeśli zmienisz nazwę tabeli, użyj strzałki odświeżania, aby zobaczyć zmiany.
  • Rozwiń węzeł Widoki , aby wyświetlić listę widoków w bazie danych. Rozwiń widok, aby wyświetlić kolumny w widoku. Użyj wielokropka, aby wybrać 1000 pierwszych wierszy lub zmienić nazwę widoku. Jeśli zmienisz nazwę widoku, użyj strzałki odświeżania, aby zobaczyć zmiany.
  • Rozwiń węzeł Procedury składowane, aby wyświetlić listę wszystkich procedur składowanych w bazie danych. Rozwiń procedurę składowaną, aby wyświetlić dane wyjściowe procedury składowanej. Użyj wielokropka, aby wyświetlić definicję procedury składowanej w oknie zapytania.

Okno zapytania

To okno pozwala wpisać lub wkleić zapytanie, a następnie uruchomić je. Wyniki zapytania są wyświetlane w okienku Wyniki .

Możesz anulować zapytanie. Jak wspomniano w obszarze Zagadnienia i ograniczenia, istnieje okres limitu czasu pięciu minut.

Przycisk Zapisz zapytanie umożliwia zapisanie tekstu zapytania na komputerze jako pliku .sql .

Przycisk Eksportuj dane jako umożliwia wyeksportowanie wyników zapytania na komputer jako .json, .csv lub plik .xml .

Czas wykonywania zapytania lub błędy są wyświetlane na pasku stanu.

Umiejętności platformy Microsoft Copilot w usłudze Azure SQL Database (wersja zapoznawcza)

Microsoft Copilot to asystent sztucznej inteligencji zaprojektowany w celu usprawnienia projektowania, działania, optymalizacji i kondycji aplikacji opartych na usłudze Azure SQL Database. Zwiększa to produktywność w witrynie Azure Portal, oferując język naturalny konwersji SQL i samodzielnej pomocy w zakresie administrowania bazą danych.

Język naturalny do środowiska SQL w edytorze zapytań witryny Azure Portal dla usługi Azure SQL Database tłumaczy zapytania języka naturalnego na język SQL, dzięki czemu interakcje z bazą danych będą bardziej intuicyjne.

Aby zapoznać się z samouczkiem i przykładami języka naturalnego do możliwości języka SQL w aplikacji Copilot, zobacz Język naturalny do języka SQL w edytorze zapytań w witrynie Azure Portal (wersja zapoznawcza). Aby uzyskać więcej informacji, zobacz Często zadawane pytania dotyczące umiejętności platformy Microsoft Copilot w usłudze Azure SQL Database (wersja zapoznawcza).

Edytor danych

Edytor danych umożliwia modyfikowanie danych w istniejącym wierszu, dodawanie nowego wiersza danych do tabeli lub usuwanie wiersza danych. Jest to podobne do środowiska w programie SQL Server Management Studio (SSMS).

Aby uzyskać dostęp do edytora danych, w eksploratorze obiektów rozwiń węzeł Tabele, a następnie wybierz wielokropek po prawej stronie nazwy tabeli i wybierz pozycję Edytuj dane (wersja zapoznawcza).

Aby zmodyfikować dane w istniejącym wierszu, wybierz wartość, którą chcesz zmienić, wprowadź zmianę, a następnie wybierz pozycję Zapisz u góry.

  • Jeśli kolumna jest kolumną tożsamości, nie można edytować tej wartości. Zostanie wyświetlony komunikat o błędzie: Save failed: Failed to execute query. Error: Cannot update identity column *column_name*.

Aby dodać nowy wiersz, wybierz pozycję Utwórz nowy wiersz i wprowadź wartości, które chcesz dodać. Istnieją pewne typy danych, z których nie można dodać ani pracować w tym kontekście.

  • Jeśli kolumna jest kolumną tożsamości, nie można dodać wartości w tym polu. Zostanie wyświetlony komunikat o błędzie: Save failed: Cannot set value in identity columns *column_name*.
  • Kolumny z domyślnymi ograniczeniami nie są honorowane. Edytor danych nie wygeneruje wartości domyślnej. Oczekuje się, że wprowadzisz wartość. Nie zaleca się używania edytora danych dla tabel, które mają domyślne ograniczenia kolumn.
  • Obliczone kolumny nie są obliczane. Zostanie wyświetlony komunikat 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. o błędzie Nie zaleca się używania edytora danych dla tabel, które mają obliczone kolumny.

Aby usunąć wiersz danych, wybierz wiersz i wybierz pozycję Usuń wiersz.

  • Jeśli wiersz ma klucz podstawowy, a ten klucz podstawowy ma relację klucza obcego z inną tabelą, po usunięciu wiersza powiązane wiersze w innej tabeli również zostaną usunięte.

Rozważania i ograniczenia

Podczas nawiązywania połączenia z usługą Azure SQL Database i wykonywania zapytań względem usługi Azure SQL Database za pomocą edytora zapytań w witrynie Azure Portal obowiązują następujące zagadnienia i ograniczenia.

Ograniczenia edytora zapytań

  • Jeśli zapytanie ma wiele instrukcji, na karcie Wyniki są wyświetlane tylko wyniki ostatniej instrukcji.
  • Edytor zapytań nie obsługuje nawiązywania połączenia z bazą danych serwera master logicznego. Aby nawiązać połączenie z bazą master danych, użyj innych narzędzi do wykonywania zapytań względem usługi Azure SQL Database.
  • Edytor zapytań nie może nawiązać połączenia z bazą danych repliki za pomocą polecenia ApplicationIntent=ReadOnly. Aby nawiązać połączenie w ten sposób, użyj programu SSMS i określ ApplicationIntent=ReadOnly na karcie Dodatkowe parametry połączenia w opcjach połączenia. Aby uzyskać więcej informacji, zobacz Nawiązywanie połączenia z repliką tylko do odczytu.
  • Edytor zapytań ma 5-minutowy limit czasu wykonywania zapytań. Aby uruchomić dłuższe zapytania, użyj innych narzędzi do wykonywania zapytań względem usługi Azure SQL Database.
  • Edytor zapytań obsługuje tylko cylindryczne projekcje dla typów danych geograficznych.
  • Edytor zapytań nie obsługuje funkcji IntelliSense dla tabel i widoków bazy danych, ale obsługuje autouzupełnianie nazw, które zostały już wpisane. W przypadku obsługi funkcji IntelliSense użyj innych narzędzi do wykonywania zapytań dotyczących usługi Azure SQL Database.
  • Naciśnięcie F5 odświeża stronę edytora zapytań, a wszystkie zapytania obecnie w edytorze nie są zapisywane.

Inne sposoby wykonywania zapytań dotyczących usługi Azure SQL Database

Oprócz edytora zapytań witryny Azure Portal dla usługi Azure SQL Database rozważ następujące przewodniki Szybki start dotyczące innych narzędzi:

Zagadnienia dotyczące połączeń

  • W przypadku połączeń publicznych z edytorem zapytań należy dodać wychodzący adres IP do reguł zapory dozwolonych przez serwer w celu uzyskania dostępu do baz danych.
    • Nie musisz dodawać adresu IP do reguł zapory programu SQL Server, jeśli masz skonfigurowane połączenie usługi Private Link na serwerze i nawiązujesz połączenie z serwerem z poziomu prywatnej sieci wirtualnej.

Rozwiązywanie problemów z błędem połączenia

  • Jeśli zostanie wyświetlony komunikat The X-CSRF-Signature header could not be validatedo błędzie , wykonaj następujące czynności, aby rozwiązać problem:

    • Sprawdź, czy zegar komputera jest ustawiony na właściwą godzinę i strefę czasową. Możesz spróbować dopasować strefę czasową komputera z platformą Azure, wyszukując strefę czasową dla lokalizacji bazy danych, taką jak Wschodnie stany USA.
    • Jeśli korzystasz z sieci serwera proxy, upewnij się, że nagłówek X-CSRF-Signature żądania nie jest modyfikowany ani porzucony.
  • Jeśli baza danych jest bezserwerowa i zostanie wyświetlony komunikat o błędzie: 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* Oznacza to, że baza danych bezserwerowa jest obecnie wstrzymana. W takim przypadku wybranie Continue as <user@domain> polecenia spowoduje wysłanie żądania do bazy danych w celu wznowienia. Zaczekaj około minutę, odśwież stronę i spróbuj ponownie.

  • Jeśli zostanie wyświetlony komunikat o błędzie "Logowanie użytkownika <token-identified principal>nie powiodło się. Serwer nie jest obecnie skonfigurowany do akceptowania tego tokenu." podczas próby użycia uwierzytelniania usługi AD użytkownik nie ma dostępu do bazy danych.

Łączność portów 443 i 1443

W edytorze zapytań może wystąpić jeden z następujących błędów:

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

Te błędy występują, ponieważ edytor zapytań nie może komunikować się za pośrednictwem portów 443 i 1443. Musisz włączyć wychodzący ruch HTTPS na tych portach. Poniższe instrukcje przeprowadzą Cię przez ten proces w zależności od systemu operacyjnego. Aby otworzyć to połączenie w sieci lokalnej, dział IT firmy może wymagać zatwierdzenia.

Zezwalaj na 443 i 1443 w zaporze windows Defender

  1. Otwórz zaporę Windows Defender.
  2. W menu po lewej stronie wybierz pozycję Ustawienia zaawansowane.
  3. W obszarze Zapora Windows Defender z zabezpieczeniami zaawansowanymi wybierz pozycję Reguły ruchu wychodzącego w menu po lewej stronie.
  4. Wybierz pozycję Nowa reguła w menu po prawej stronie.
  5. W kreatorze Nowej reguły ruchu wychodzącego wykonaj następujące kroki:
    1. Wybierz port jako typ reguły, którą chcesz utworzyć, a następnie wybierz przycisk Dalej.
    2. Wybierz pozycję TCP.
    3. Wybierz pozycję Określone porty zdalne, wprowadź ciąg 443, 1443, a następnie wybierz pozycję Dalej.
    4. Wybierz pozycję Zezwalaj na połączenie, jeśli jest bezpieczne, wybierz przycisk Dalej, a następnie ponownie wybierz przycisk Dalej .
    5. Pozostaw wybraną opcję Domena, Prywatna i Publiczna.
    6. Nadaj regule nazwę, na przykład Uzyskaj dostęp do edytora zapytań usługi Azure SQL i opcjonalnie podaj opis. Następnie wybierz pozycję Zakończ.

Zezwalaj na 443 i 1443 w systemie macOS

  1. W menu firmy Apple otwórz pozycję Preferencje systemowe.
  2. Wybierz pozycję Zabezpieczenia i prywatność, a następnie wybierz pozycję Zapora.
  3. Jeśli zapora jest wyłączona, wybierz pozycję Kliknij blokadę, aby wprowadzić zmiany, a następnie wybierz pozycję Włącz zaporę.
  4. Wybierz pozycję Opcje zapory.
  5. W oknie Zabezpieczenia i prywatność wybierz pozycję Automatycznie zezwalaj podpisanym oprogramowaniu na odbieranie połączeń przychodzących.

Zezwalaj na 443 i 1443 w systemie Linux

Uruchom następujące polecenia, aby zaktualizować iptablespolecenie :

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

Zezwalaj na 443 i 1443 na maszynie wirtualnej platformy Azure

W przypadku korzystania z maszyn wirtualnych platformy Azure masz sieciową grupę zabezpieczeń platformy Azure blokującą łączność. Sieciowa grupa zabezpieczeń może filtrować przychodzący i wychodzący ruch sieciowy do i z zasobów platformy Azure w sieci wirtualnej platformy Azure. Musisz dodać regułę zabezpieczeń dla ruchu wychodzącego do sieciowej grupy zabezpieczeń. Aby zapoznać się z przykładem, zobacz Tworzenie reguł zabezpieczeń.

Następny krok