Szybki start: tworzenie serwera Azure Database for PostgreSQL przy użyciu interfejsu wiersza polecenia platformy Azure

W tym przewodniku Szybki start pokazano, jak za pomocą poleceń interfejsu wiersza polecenia platformy Azure Azure Cloud Shell utworzyć pojedynczy serwer 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.

Wymagania wstępne

  • Ten artykuł wymaga interfejsu wiersza polecenia platformy Azure w wersji 2.0 lub nowszej. Jeśli używasz Azure Cloud Shell, najnowsza wersja jest już zainstalowana.

    Porada

    Rozważ użycie prostszego polecenia az postgres up interfejsu wiersza polecenia platformy Azure, które jest obecnie dostępne w wersji zapoznawczej. Wypróbuj przewodnik Szybki start.

  • Wybierz określony identyfikator subskrypcji w ramach swojego konta przy użyciu polecenia az account set.

    • Zanotuj wartość identyfikatora z danych wyjściowych polecenia az login, która ma być wartością argumentu subskrypcji w poleceniu .

      az account set --subscription <subscription id>
      
    • Jeśli masz wiele subskrypcji, wybierz odpowiednią subskrypcję, w ramach której powinny być naliczane opłaty za ten zasób. Aby uzyskać wszystkie subskrypcje, użyj az account list.

Tworzenie serwera usługi Azure Database for PostgreSQL

Utwórz grupę zasobów platformy Azure za pomocą polecenia az group create, a następnie utwórz serwer 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 westus.

az group create --name myresourcegroup --location westus

Utwórz serwer Azure Database for PostgreSQL za pomocą polecenia az postgres server create. Serwer może zawierać wiele baz danych.

az postgres server create --resource-group myresourcegroup --name mydemoserver  --location westus --admin-user myadmin --admin-password <server_admin_password> --sku-name GP_Gen5_2 

Poniżej znajdują się szczegółowe informacje dotyczące poprzednich argumentów:

Ustawienie Wartość przykładowa Opis
name mydemoserver Unikatowa nazwa identyfikująca Azure Database for PostgreSQL serwera. Nazwa serwera może zawierać tylko małe litery, cyfry i znaki łącznika (-). Musi zawierać od 3 do 63 znaków. Aby uzyskać więcej informacji, zobacz Azure Database for PostgreSQL Naming Rules ( Reguły nazewnictwa).
resource-group myresourcegroup Nazwa grupy zasobów platformy Azure.
location westus Lokalizacja platformy Azure dla serwera.
admin-user myadmin Nazwa użytkownika logowania administratora. Nie można go używać w azure_superuser, administratora, administratora, głównego, gościa ani publicznego .
admin-password bezpieczne hasło Hasło użytkownika administratora. Musi zawierać od 8 do 128 znaków z trzech z następujących kategorii: wielkie litery angielskie, małe litery angielskie, cyfry i znaki inne niż alfanumeryczne.
sku-name GP_Gen5_2 Nazwa warstwy cenowej i konfiguracji obliczeń. W skrócie postępuj zgodnie z konwencją {warstwa cenowa}{generacja obliczeń}{rdzenie wirtualne}. Aby uzyskać więcej informacji, zobacz Azure Database for PostgreSQL cennika.

Ważne

  • Domyślna wersja serwera PostgreSQL to 9.6. Aby wyświetlić wszystkie obsługiwane wersje, zobacz Obsługiwane wersje główne postgreSQL.
  • Aby wyświetlić wszystkie argumenty polecenia az postgres server create, zobacz ten dokument referencyjny.
  • Protokół SSL jest domyślnie włączony na serwerze. Aby uzyskać więcej informacji na temat protokołu SSL, zobacz Konfigurowanie łączności SSL.

Konfigurowanie reguły zapory na poziomie serwera

Domyślnie utworzony serwer nie jest publicznie dostępny i jest chroniony za pomocą reguł zapory. Reguły zapory na serwerze można skonfigurować za pomocą polecenia az postgres server firewall-rule create, aby udzielić środowisku lokalnemu dostępu do nawiązywania połączenia z serwerem.

Poniższy przykład powoduje utworzenie reguły zapory o nazwie AllowMyIP, która zezwala na połączenia z określonego adresu IP – 192.168.0.1. Zastąp adres IP lub zakres adresów IP odpowiadający miejscu, z którego będziesz nawiązywać połączenie. Jeśli nie znasz swojego adresu IP, przejdź do WhatIsMyIPAddress.com, aby go uzyskać.

az postgres server firewall-rule create --resource-group myresourcegroup --server mydemoserver --name AllowMyIP --start-ip-address 192.168.0.1 --end-ip-address 192.168.0.1

Uwaga

Aby uniknąć problemów z łącznością, upewnij się, że zapora sieciowa zezwala na port 5432. Azure Database for PostgreSQL używają tego portu.

Pobieranie informacji o połączeniu

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

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

Wynik jest w formacie JSON. Zanotuj wartości administratorLogin i fullyQualifiedDomainName.

{
  "administratorLogin": "myadmin",
  "earliestRestoreDate": null,
  "fullyQualifiedDomainName": "mydemoserver.postgres.database.azure.com",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myresourcegroup/providers/Microsoft.DBforPostgreSQL/servers/mydemoserver",
  "location": "westus",
  "name": "mydemoserver",
  "resourceGroup": "myresourcegroup",
  "sku": {
    "capacity": 2,
    "family": "Gen5",
    "name": "GP_Gen5_2",
    "size": null,
    "tier": "GeneralPurpose"
  },
  "sslEnforcement": "Enabled",
  "storageProfile": {
    "backupRetentionDays": 7,
    "geoRedundantBackup": "Disabled",
    "storageMb": 5120
  },
  "tags": null,
  "type": "Microsoft.DBforPostgreSQL/servers",
  "userVisibleState": "Ready",
  "version": "9.6"
}

Nawiązywanie połączenia z serwerem Azure Database for PostgreSQL przy użyciu narzędzia psql

Klient psql jest popularnym wyborem podczas nawiązywania połączenia z serwerami PostgreSQL. Połączenie z serwerem można nawiązać za pomocą narzędzia psql zAzure Cloud Shell . Narzędzia psql można również używać w środowisku lokalnym, jeśli jest dostępne. Pusta baza danych postgres jest tworzona automatycznie przy użyciu nowego serwera PostgreSQL. Możesz użyć tej bazy danych do nawiązania połączenia z psql, jak pokazano w poniższym kodzie.

psql --host=mydemoserver.postgres.database.azure.com --port=5432 --username=myadmin@mydemoserver --dbname=postgres

Porada

Jeśli wolisz użyć ścieżki url do nawiązania połączenia z postgres, zakoduj znak @ w nazwie użytkownika za pomocą %40 . Na przykład parametrów połączenia dla psql będą:

psql postgresql://myadmin%40mydemoserver@mydemoserver.postgres.database.azure.com:5432/postgres

Czyszczenie zasobów

Jeśli te zasoby nie są potrzebne w innym przewodniku Szybki start lub samouczku, możesz je usunąć, uruchamiając następujące polecenie.

az group delete --name myresourcegroup

Jeśli chcesz tylko usunąć jeden z nowo utworzonych serwerów, możesz uruchomić polecenie az postgres server delete.

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

Następne kroki