Szybki start: tworzenie wystąpienia usługi Azure Database for PostgreSQL — serwer elastyczny przy użyciu interfejsu wiersza polecenia platformy Azure

DOTYCZY: Azure Database for PostgreSQL — serwer elastyczny

W tym przewodniku Szybki start pokazano, jak za pomocą poleceń interfejsu wiersza polecenia platformy Azure w usłudze Azure Cloud Shell utworzyć elastyczne wystąpienie serwera usługi Azure Database for PostgreSQL w ciągu pięciu minut. Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.

Uruchamianie usługi Azure Cloud Shell

Usługa Azure Cloud Shell to bezpłatna interaktywna powłoka, której można użyć do wykonania kroków opisanych w tym artykule. Udostępnia ona wstępnie zainstalowane i najczęściej używane narzędzia platformy Azure, które są skonfigurowane do użycia na koncie.

Aby otworzyć usługę Cloud Shell, wybierz pozycję Wypróbuj w prawym górnym rogu bloku kodu. Możesz również otworzyć usługę Cloud Shell na osobnej karcie przeglądarki, przechodząc do .https://shell.azure.com/bash Wybierz pozycję Kopiuj , aby skopiować bloki kodu, wklej go w usłudze Cloud Shell, a następnie wybierz klawisz Enter , aby go uruchomić.

Jeśli wolisz zainstalować interfejs wiersza polecenia i korzystać z niego lokalnie, ten przewodnik Szybki start wymaga interfejsu wiersza polecenia platformy Azure w wersji 2.0 lub nowszej. Uruchom polecenie az --version, aby dowiedzieć się, jaka wersja jest używana. Jeśli konieczna będzie instalacja lub uaktualnienie, zobacz Instalowanie interfejsu wiersza polecenia platformy Azure.

Wymagania wstępne

Musisz zalogować się do swojego konta przy użyciu polecenia az login . Zanotuj właściwość id w danych wyjściowych, która odwołuje się do identyfikatora subskrypcji dla konta platformy Azure.

az login

Wybierz określoną subskrypcję w ramach konta przy użyciu polecenia az account set . Użyj wartości id z danych wyjściowych az login, aby użyć jako wartości argumentu subskrypcji w poleceniu . Jeśli masz wiele subskrypcji, wybierz odpowiednią subskrypcję, w ramach której powinny być naliczane opłaty za ten zasób. Aby uzyskać całą subskrypcję, użyj polecenia az account list.

az account set --subscription <subscription id>

Tworzenie serwera elastycznego

Utwórz grupę zasobów platformy Azure przy użyciu az group create polecenia , a następnie utwórz wystąpienie serwera elastycznego usługi Azure Database for PostgreSQL w tej grupie zasobów. Należy podać unikatową nazwę. Poniższy przykład obejmuje tworzenie grupy zasobów o nazwie myresourcegroup w lokalizacji eastus.

az group create --name myresourcegroup --location eastus

Utwórz elastyczne wystąpienie serwera usługi Azure Database for PostgreSQL za az postgres flexible-server create pomocą polecenia . Serwer może zawierać wiele baz danych. Następujące polecenie tworzy serwer w utworzonej grupie zasobów:

az postgres flexible-server create --name mydemoserver --resource-group myresourcegroup

Ponieważ domyślną metodą łączności jest publiczny dostęp (dozwolone adresy IP), polecenie wyświetli monit o potwierdzenie, czy chcesz dodać swój adres IP i/lub wszystkie adresy IP (zakres obejmujący od 0.0.0.0.0 do 255.255.255.255.255) do listy dozwolonych adresów.

Utworzony serwer ma następujące atrybuty:

  • Ta sama lokalizacja co grupa zasobów
  • Automatycznie wygenerowana nazwa użytkownika administratora i hasło administratora (które należy zapisać w bezpiecznym miejscu)
  • Domyślna baza danych o nazwie "flexibleserverdb"
  • Wartości domyślne usługi dla pozostałych konfiguracji serwera: warstwa obliczeniowa (ogólnego przeznaczenia), rozmiar obliczeniowy/jednostka SKU (Standard_D2s_v3 - 2 rdzenie wirtualne, 8 GB pamięci RAM), okres przechowywania kopii zapasowych (7 dni) i wersja bazy danych PostgreSQL (13)

Uwaga

Nie można zmienić metody łączności po utworzeniu serwera. Jeśli na przykład podczas tworzenia wybrano opcję Dostęp prywatny (integracja z siecią wirtualną), po utworzeniu nie można zmienić go na Dostęp publiczny (dozwolone adresy IP). Zdecydowanie zalecamy utworzenie serwera z dostępem prywatnym, aby bezpiecznie uzyskać dostęp do serwera przy użyciu integracji z siecią wirtualną. Dowiedz się więcej o dostępie prywatnym w artykule pojęcia.

Jeśli chcesz zmienić ustawienia domyślne, zapoznaj się z dokumentacją interfejsu wiersza polecenia platformy Azure dotyczącą polecenia az postgres flexible-server create.

Uwaga

Połączenie ions do serwera elastycznego usługi Azure Database for PostgreSQL komunikują się za pośrednictwem portu 5432. Jeśli spróbujesz nawiązać połączenie z sieci firmowej, ruch wychodzący przez port 5432 może być niedozwolony. W takim przypadku nie można nawiązać połączenia z serwerem, chyba że dział IT otworzy port 5432. Zwróć uwagę, że jeśli włączysz usługę PgBouncer na wystąpieniu serwera elastycznego usługi Azure Database for PostgreSQL i chcesz nawiązać z nim połączenie, ponieważ działa on na porcie 6432, jest to port, który dział IT musi otworzyć dla ruchu wychodzącego.

Uzyskiwanie informacji o połączeniu

Aby nawiązać połączenie z serwerem, musisz podać informacje o hoście i poświadczenia dostępu.

az postgres flexible-server show --name mydemoserver --resource-group myresourcegroup

Wynik jest w formacie JSON. Zanotuj wartości fullyQualifiedDomainName i administratorLogin. Hasło powinno zostać zapisane w poprzednim kroku.

{
  "administratorLogin": "myadmin",
  "availabilityZone": "3",
  "backup": {
    "backupRetentionDays": 7,
    "earliestRestoreDate": "2022-10-20T18:03:50.989428+00:00",
    "geoRedundantBackup": "Disabled"
  },
  "earliestRestoreDate": null,
  "fullyQualifiedDomainName": "mydemoserver.postgres.database.azure.com",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/mydemoserver",
  "location": "eastus",
  "name": "mydemoserver",
  "network": {
    "delegatedSubnetResourceId": null,
    "privateDnsZoneArmResourceId": null,
    "publicNetworkAccess": "Enabled"
  },
  "resourceGroup": "myresourcegroup",
  "sku": {
    "name": "Standard_D2s_v3",
    "tier": "GeneralPurpose"
  },
  "state": "Ready",
  "storage": {
    "storageSizeGb": 128
  },
  "tags": null,
  "type": "Microsoft.DBforPostgreSQL/flexibleServers",
  "version": "13"
}

Połączenie przy użyciu klienta wiersza polecenia PostgreSQL

Najpierw zainstaluj narzędzie wiersza polecenia psql .

Za pomocą narzędzia psql połącz się z bazą danych "flexibleserverdb" przy użyciu następującego polecenia. Zastąp wartości automatycznie wygenerowaną nazwą domeny i nazwą użytkownika.

psql -h mydemoserver.postgres.database.azure.com -U myadmin flexibleserverdb

Uwaga

Jeśli wystąpi błąd The parameter PrivateDnsZoneArguments is required, and must be provided by customer, oznacza to, że możesz uruchomić starszą wersję interfejsu wiersza polecenia platformy Azure. Uaktualnij interfejs wiersza polecenia platformy Azure i ponów próbę wykonania operacji.

Czyszczenie zasobów

Jeśli te zasoby nie są Ci potrzebne do pracy z innym przewodnikiem Szybki start lub samouczkiem, możesz je usunąć, uruchamiając następujące polecenie:

az group delete --name myresourcegroup

Jeśli chcesz usunąć tylko nowo utworzony serwer, możesz uruchomić az postgres flexible-server delete polecenie .

az postgres flexible-server delete --resource-group myresourcegroup --name mydemoserver

Następne kroki