Udostępnij za pośrednictwem


Szybki start: tworzenie serwera usługi Azure Database for MariaDB przy użyciu programu PowerShell

Ważne

Usługa Azure Database for MariaDB znajduje się na ścieżce wycofania. Zdecydowanie zalecamy przeprowadzenie migracji do usługi Azure Database for MySQL. Aby uzyskać więcej informacji na temat migracji do usługi Azure Database for MySQL, zobacz Co się dzieje z usługą Azure Database for MariaDB?.

W tym przewodniku Szybki start opisano sposób tworzenia serwera usługi Azure Database for MariaDB w grupie zasobów platformy Azure przy użyciu programu PowerShell. Za pomocą programu PowerShell można tworzyć zasoby platformy Azure i zarządzać nimi interaktywnie lub w skryptach.

Wymagania wstępne

Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.

Jeśli zdecydujesz się używać programu PowerShell lokalnie, ten artykuł wymaga zainstalowania modułu Az programu PowerShell i nawiązania połączenia z kontem platformy Azure przy użyciu polecenia cmdlet Connect-AzAccount . Aby uzyskać więcej informacji na temat instalowania modułu Az programu PowerShell, zobacz Instalowanie programu Azure PowerShell.

Ważne

Chociaż moduł Az.MariaDb programu PowerShell jest w wersji zapoznawczej, należy zainstalować go oddzielnie od modułu Az programu PowerShell przy użyciu następującego polecenia: Install-Module -Name Az.MariaDb -AllowPrerelease. Gdy moduł Az.MariaDb programu PowerShell jest ogólnie dostępny, staje się on częścią przyszłych wersji modułu Az programu PowerShell i jest dostępny natywnie z poziomu usługi Azure Cloud Shell.

Jeśli używasz usługi Azure Database for MariaDB po raz pierwszy, musisz zarejestrować dostawcę zasobów Microsoft.DBforMariaDB .

Register-AzResourceProvider -ProviderNamespace Microsoft.DBforMariaDB

Azure Cloud Shell

Na platforma Azure hostowane jest Azure Cloud Shell, interaktywne środowisko powłoki, z którego można korzystać w przeglądarce. Do pracy z usługami platformy Azure można używać programu Bash lub PowerShell w środowisku Cloud Shell. Aby uruchomić kod w tym artykule, możesz użyć wstępnie zainstalowanych poleceń usługi Cloud Shell bez konieczności instalowania niczego w środowisku lokalnym.

Aby uruchomić środowisko Azure Cloud Shell:

Opcja Przykład/link
Wybierz pozycję Wypróbuj w prawym górnym rogu bloku kodu lub polecenia. Wybranie pozycji Wypróbuj nie powoduje automatycznego skopiowania kodu lub polecenia do usługi Cloud Shell. Zrzut ekranu przedstawiający przykład narzędzia Try It dla usługi Azure Cloud Shell.
Przejdź do witryny https://shell.azure.com lub wybierz przycisk Uruchom Cloud Shell, aby otworzyć środowisko Cloud Shell w przeglądarce. Przycisk uruchamiania usługi Azure Cloud Shell.
Wybierz przycisk Cloud Shell na pasku menu w prawym górnym rogu witryny Azure Portal. Zrzut ekranu przedstawiający przycisk usługi Cloud Shell w witrynie Azure Portal

Aby użyć usługi Azure Cloud Shell:

  1. Uruchom usługę Cloud Shell.

  2. Wybierz przycisk Kopiuj w bloku kodu (lub bloku poleceń), aby skopiować kod lub polecenie.

  3. Wklej kod lub polecenie do sesji usługi Cloud Shell, wybierając Ctrl+Shift V w systemach Windows i Linux lub wybierając pozycję Cmd+Shift++V w systemie macOS.

  4. Wybierz Enter, aby uruchomić kod lub polecenie.

Jeśli masz wiele subskrypcji platformy Azure, wybierz odpowiednią subskrypcję, w której mają być rozliczane zasoby. Wybierz określony identyfikator subskrypcji przy użyciu polecenia cmdlet Set-AzContext .

Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000

Tworzenie grupy zasobów

Utwórz grupę zasobów platformy Azure przy użyciu polecenia cmdlet New-AzResourceGroup. Grupa zasobów to logiczny kontener przeznaczony do wdrażania zasobów platformy Azure i zarządzania nimi w formie grupy.

Poniższy przykład tworzy grupę zasobów o nazwie myresourcegroup w regionie Zachodnie stany USA .

New-AzResourceGroup -Name myresourcegroup -Location westus

Tworzenie serwera usługi Azure Database for MariaDB

Utwórz serwer usługi Azure Database for MariaDB za New-AzMariaDbServer pomocą polecenia cmdlet . Serwer umożliwia zarządzanie wieloma bazami danych. Zwykle dla każdego projektu lub użytkownika używana jest oddzielna baza danych.

Poniższa tabela zawiera listę często używanych parametrów i przykładowych wartości dla New-AzMariaDbServer polecenia cmdlet.

Ustawienie Wartość przykładowa Opis
Nazwa/nazwisko mydemoserver Wybierz globalnie unikatową nazwę na platformie Azure, która identyfikuje serwer usługi Azure Database for MariaDB. Nazwa serwera może zawierać tylko litery, cyfry i znak łącznika (-). Wszystkie określone wielkie litery są automatycznie konwertowane na małe litery podczas procesu tworzenia. Musi zawierać od 3 do 63 znaków.
ResourceGroupName myresourcegroup Podaj nazwę grupy zasobów platformy Azure.
SKU GP_Gen5_2 Nazwa jednostki SKU. Zgodnie z konwencją pricing-tier_compute-generation_vCores w skrócie. Aby uzyskać więcej informacji na temat parametru sku, zobacz informacje opisane w tej tabeli.
BackupRetentionDay 7 Jak długo należy przechowywać kopię zapasową. Jednostka to dni. Zakres wynosi od 7 do 35.
GeoRedundantBackup Włączona Określa, czy dla tego serwera powinny być włączone kopie zapasowe geograficznie nadmiarowe. Nie można włączyć tej wartości dla serwerów w podstawowej warstwie cenowej i nie można jej zmienić po utworzeniu serwera. Dozwolone wartości: Enabled (Włączone) i Disabled (Wyłączone).
Lokalizacja westus Region platformy Azure dla serwera.
SslEnforcement Włączona Określa, czy protokół SSL powinien być włączony, czy nie dla tego serwera. Dozwolone wartości: Enabled (Włączone) i Disabled (Wyłączone).
StorageInMb 51200 Pojemność magazynu serwera (w megabajtach). Prawidłowa wartość StorageInMb wynosi co najmniej 5120 MB i zwiększa się o 1024 MB przyrostów. Aby uzyskać więcej informacji na temat limitów rozmiaru magazynu, zobacz Warstwy cenowe usługi Azure Database for MariaDB.
Wersja 5.7 Wersja główna bazy danych MariaDB.
AdministratorUserName myadmin Nazwa użytkownika w przypadku logowania administratora. Nie może być to azure_superuser, admin, administrator, root, guest ani public.
AdministratorLoginPassword <securestring> Hasło użytkownika administratora w postaci bezpiecznego ciągu. Musi zawierać od 8 do 128 znaków. Hasło musi zawierać znaki z trzech z następujących kategorii: wielkie litery angielskie, małe litery angielskie, cyfry i znaki inne niż alfanumeryczne.

Wartość parametru sku jest zgodna z konwencją pricing-tier_compute-generation_vCores, jak pokazano w poniższych przykładach.

  • -Sku B_Gen5_1 — warstwa podstawowa, 5. generacja, 1 rdzeń wirtualny. Ta opcja to najmniejsza dostępna jednostka SKU.
  • -Sku GP_Gen5_32 — warstwa ogólnego przeznaczenia, 5. generacja, 32 rdzenie wirtualne.
  • -Sku MO_Gen5_2 — warstwa zoptymalizowana pod kątem pamięci, 5. generacja, 2 rdzenie wirtualne.

Aby uzyskać informacje na temat prawidłowych wartości sku według regionów i warstw, zobacz Warstwy cenowe usługi Azure Database for MariaDB.

Poniższy przykład tworzy serwer MariaDB w regionie Zachodnie stany USA o nazwie mydemoserver w grupie zasobów myresourcegroup z identyfikatorem logowania administratora serwera myadmin. Jest to serwer 5. generacji w warstwie cenowej ogólnego przeznaczenia z włączonymi 2 rdzeniami wirtualnymi i geograficznie nadmiarowymi kopiami zapasowymi. Dokumentuj hasło używane w pierwszym wierszu przykładu, ponieważ jest to hasło dla konta administratora serwera MariaDB.

Napiwek

Nazwa serwera jest mapowana na nazwę usługi DNS i musi być globalnie unikatowa na platformie Azure.

$Password = Read-Host -Prompt 'Please enter your password' -AsSecureString
New-AzMariaDbServer -Name mydemoserver -ResourceGroupName myresourcegroup -Sku GP_Gen5_2 -GeoRedundantBackup Enabled -Location westus -AdministratorUsername myadmin -AdministratorLoginPassword $Password

Rozważ użycie podstawowej warstwy cenowej, jeśli lekkie obliczenia i operacje we/wy są odpowiednie dla obciążenia.

Ważne

Serwery utworzone w podstawowej warstwie cenowej nie mogą być później skalowane do warstwy ogólnego przeznaczenia lub zoptymalizowane pod kątem pamięci i nie mogą być replikowane geograficznie.

Konfigurowanie reguły zapory

Utwórz regułę zapory na poziomie serwera usługi Azure Database for MariaDB przy użyciu New-AzMariaDbFirewallRule polecenia cmdlet . Reguła zapory na poziomie serwera umożliwia aplikacji zewnętrznej, takiej jak mysql narzędzie wiersza polecenia lub program MariaDB Workbench, aby nawiązać połączenie z serwerem za pośrednictwem zapory usługi Azure Database for MariaDB.

Poniższy przykład tworzy regułę 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ących lokalizacji, z której nawiązujesz połączenie.

New-AzMariaDbFirewallRule -Name AllowMyIP -ResourceGroupName myresourcegroup -ServerName mydemoserver -StartIPAddress 192.168.0.1 -EndIPAddress 192.168.0.1

Uwaga

Połączenia z usługą Azure Database for MariaDB korzystają z portu 3306. Jeśli próbujesz nawiązać połączenie z sieci firmowej, ruch wychodzący na porcie 3306 może być zablokowany. W tym scenariuszu można nawiązać połączenie tylko z serwerem, jeśli dział IT otworzy port 3306.

Konfigurowanie ustawień SSL

Domyślnie połączenia SSL między Twoim serwerem i aplikacjami klienckimi są wymuszane. To ustawienie domyślne zapewnia bezpieczeństwo danych w ruchu przez szyfrowanie strumienia danych za pośrednictwem Internetu. W tym przewodniku Szybki start wyłącz połączenia SSL dla Twojego serwera. Aby uzyskać więcej informacji, zobacz Configure SSL connectivity in your application to securely connect to Azure Database for MySQL (Konfigurowanie łączności SSL w aplikacji w celu bezpiecznego nawiązywania połączeń z usługą Azure Database for MariaDB).

Ostrzeżenie

Nie zaleca się wyłączania połączenia SSL w przypadku serwerów produkcyjnych.

Poniższy przykład wyłącza protokół SSL na serwerze usługi Azure Database for MariaDB.

Update-AzMariaDbServer -Name mydemoserver -ResourceGroupName myresourcegroup -SslEnforcement Disabled

Uzyskiwanie informacji o połączeniu

Aby nawiązać połączenie z serwerem, musisz podać informacje o hoście i poświadczenia dostępu. Użyj poniższego przykładu, aby określić informacje o połączeniu. Zanotuj wartości w obszarze FullyQualifiedDomainName i AdministratorLogin.

Get-AzMariaDbServer -Name mydemoserver -ResourceGroupName myresourcegroup |
  Select-Object -Property FullyQualifiedDomainName, AdministratorLogin
FullyQualifiedDomainName                    AdministratorLogin
------------------------                    ------------------
mydemoserver.mariadb.database.azure.com       myadmin

Nawiązywanie połączenia z serwerem przy użyciu narzędzia wiersza polecenia mysql

Nawiąż połączenie z serwerem mysql przy użyciu narzędzia wiersza polecenia. Aby pobrać i zainstalować narzędzie wiersza polecenia, zobacz Pliki do pobrania społeczności mySQL. Możesz również uzyskać dostęp do wstępnie zainstalowanej mysql wersji narzędzia wiersza polecenia w usłudze Azure Cloud Shell, wybierając przycisk Wypróbuj w przykładzie kodu w tym artykule. Inne sposoby uzyskiwania dostępu do usługi Azure Cloud Shell to wybranie >przycisku _ na prawym górnym pasku narzędzi w witrynie Azure Portal lub w shell.azure.com.

  1. Nawiąż połączenie z serwerem mysql przy użyciu narzędzia wiersza polecenia.

    mysql -h <servername>.mariadb.database.azure.com -u myadmin@<servername> -p
    
  2. Wyświetlanie stanu serwera.

    mysql> status
    
    C:\Users\>mysql -h mydemoserver.mariadb.database.azure.com -u myadmin@mydemoserver -p
    Enter password: *************
    Welcome to the MySQL monitor.  Commands end with ; or \g.
    Your MySQL connection id is 64793
    Server version: 5.6.42.0 MariaDB Server
    
    Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved.
    
    Oracle is a registered trademark of Oracle Corporation and/or its
    affiliates. Other names may be trademarks of their respective
    owners.
    
    Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
    
    mysql> status
    --------------
    /usr/bin/mysql  Ver 14.14 Distrib 5.7.29, for Linux (x86_64) using  EditLine wrapper
    
    Connection id:          64793
    Current database:
    Current user:           myadmin@myipaddress
    SSL:                    Cipher in use is ECDHE-RSA-AES256-GCM-SHA384
    Current pager:          stdout
    Using outfile:          ''
    Using delimiter:        ;
    Server version:         5.6.42.0 MariaDB Server
    Protocol version:       10
    Connection:             mydemoserver.mariadb.database.azure.com via TCP/IP
    Server characterset:    latin1
    Db     characterset:    latin1
    Client characterset:    utf8
    Conn.  characterset:    utf8
    TCP port:               3306
    Uptime:                 17 min 4 sec
    
    Threads: 19  Questions: 482  Slow queries: 0  Opens: 50  Flush tables: 3  Open tables: 12  Queries per second avg: 0.470
    --------------
    
    mysql>
    

Aby zapoznać się z dodatkowymi poleceniami, zobacz MySQL 5.7 Reference Manual - Chapter 4.5.1 (Podręcznik programu MySQL 5.7 — Rozdział 4.5.1).

Nawiązywanie połączenia z serwerem przy użyciu aplikacji MariaDB Workbench

  1. Uruchom aplikację MySQL Workbench na swoim komputerze klienckim. Aby pobrać i zainstalować aplikację MySQL Workbench, zobacz Pobieranie aplikacji MySQL Workbench.

  2. W oknie dialogowym Konfigurowanie nowego połączenia wprowadź poniższe informacje na karcie Parametry:

    konfigurowanie nowego połączenia

    Ustawienie Sugerowana wartość Opis
    Nazwa połączenia Moje połączenie Określ etykietę dla tego połączenia
    Connection Method (Metoda połączenia) Standard (TCP/IP) Użyj protokołu TCP/IP do nawiązania połączenia z usługą Azure Database for MariaDB
    Hostname (Nazwa hosta) mydemoserver.mariadb.database.azure.com Zanotowano wcześniej nazwę serwera
    Port 3306 Domyślny port dla bazy danych MariaDB
    Username myadmin@mydemoserver Zanotowany wcześniej identyfikator logowania administratora serwera
    Hasło ************* Użyj skonfigurowanego wcześniej hasła konta administratora
  3. Aby sprawdzić, czy parametry są poprawnie skonfigurowane, wybierz przycisk Testuj połączenie .

  4. Wybierz połączenie, aby nawiązać połączenie z serwerem.

Czyszczenie zasobów

Jeśli zasoby utworzone w tym przewodniku Szybki start nie są potrzebne w innym przewodniku Szybki start lub samouczku, możesz je usunąć, uruchamiając poniższy przykład.

Uwaga

Poniższy przykład usuwa określoną grupę zasobów i wszystkie zawarte w niej zasoby. Jeśli zasoby spoza zakresu tego przewodnika Szybki start istnieją w określonej grupie zasobów, zostaną również usunięte.

Remove-AzResourceGroup -Name myresourcegroup

Aby usunąć tylko serwer utworzony w tym przewodniku Szybki start bez usuwania grupy zasobów, użyj Remove-AzMariaDbServer polecenia cmdlet .

Remove-AzMariaDbServer -Name mydemoserver -ResourceGroupName myresourcegroup

Następne kroki