Administración con la CLI de Azure de una instancia de Azure Database for PostgreSQL: Servidor único
Se aplica a:
Azure Database for PostgreSQL: servidor único
Importante
El servicio de servidor único de Azure Database for PostgreSQL está en proceso de retirada. Es muy recomendable actualizar al servidor flexible de Azure Database for PostgreSQL: servidor flexible. Para más información sobre la migración al servidor flexible de Azure Database for PostgreSQL, consulte ¿Qué sucederá con el servicio de servidor único de Azure Database for PostgreSQL?
En este artículo se muestra cómo administrar los servidores únicos implementados en Azure. Entre las tareas de administración se incluyen el escalado de proceso y almacenamiento, el restablecimiento de contraseñas de administración y la visualización de detalles del servidor.
Requisitos previos
Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar. En este artículo es necesario que ejecute la versión 2.0 de la CLI de Azure, o cualquier versión posterior, de forma local. Para ver la versión instalada, ejecute el comando az --version. Si necesita instalarla o actualizarla, vea Instalación de la CLI de Azure.
Será preciso que inicie sesión en su cuenta mediante el comando az login. Tenga en cuenta la propiedad id, que hace referencia al identificador de suscripción para su cuenta de Azure.
az login
Seleccione la suscripción específica en su cuenta mediante el comando az account set. Anote el valor de id de la salida de az login para usarlo como valor del argumento subscription del comando. Si tiene varias suscripciones, elija la suscripción adecuada en la que se debe facturar el recurso. Para obtener todas las suscripciones, use az account list.
az account set --subscription <subscription id>
Si aún no ha creado un servidor, consulte esta guía de inicio rápido para crear uno.
Azure Cloud Shell
En Azure se hospeda Azure Cloud Shell, un entorno de shell interactivo que puede utilizar mediante el explorador. Puede usar Bash o PowerShell con Cloud Shell para trabajar con los servicios de Azure. Puede usar los comandos preinstalados de Cloud Shell para ejecutar el código de este artículo sin tener que instalar nada en su entorno local.
Para iniciar Azure Cloud Shell:
| Opción | Ejemplo o vínculo |
|---|---|
| Seleccione Pruébelo en la esquina superior derecha de un bloque de código o de comandos. Solo con seleccionar Pruébelo no se copia automáticamente el código o comando en Cloud Shell. |  |
| Vaya a https://shell.azure.com o seleccione el botón Iniciar Cloud Shell para abrir Cloud Shell en el explorador. |  |
| Seleccione el botón Cloud Shell en la barra de menús de la esquina superior derecha de Azure Portal. |  |
Para usar Azure Cloud Shell:
Inicie Cloud Shell.
Seleccione el botón Copiar en un bloque de código (o bloque de comandos) para copiar el código o comando.
Pegue el código o comando en la sesión de Cloud Shell. Para ello, seleccione Ctrl+Mayús+V en Windows y Linux, o bien seleccione Cmd+Mayús+V en macOS.
Seleccione Enter para ejecutar el código o comando.
Escalado de proceso y almacenamiento
Puede escalar verticalmente su plan de tarifa de forma sencilla, así como el proceso y el almacenamiento con el siguiente comando. Puede ver toda la operación del servidor que puede realizar con az postgres server overview.
az postgres server update --resource-group myresourcegroup --name mydemoserver --sku-name GP_Gen5_4 --storage-size 6144
Estos son los datos de los argumentos anteriores:
| Configuración | Valor de ejemplo | Descripción |
|---|---|---|
| name | mydemoserver | Escriba un nombre único para el servidor de Azure Database for PostgreSQL. El nombre del servidor solo puede contener letras minúsculas, números y el carácter de guion (-). Debe contener entre 3 y 63 caracteres. |
| resource-group | myresourcegroup | Especifique el nombre del grupo de recursos de Azure. |
| sku-name | GP_Gen5_2 | Escriba el nombre del plan de tarifa y la configuración del proceso. Sigue la convención {plan de tarifa} {generación de procesos} {núcleos virtuales} en forma abreviada. Para más información, consulte los planes de tarifa. |
| storage-size | 6144 | La capacidad de almacenamiento del servidor (la unidad es megabytes). El mínimo es 5120 y aumenta en incrementos de 1024. |
Importante
- El almacenamiento se puede escalar verticalmente, pero no reducir.
- No se permite el escalado vertical de un plan de tarifa Básico a uno de uso general ni a uno optimizado para memoria. Puede escalar verticalmente de forma manual mediante un script de Bash o con PostgreSQL Workbench.
Administre bases de datos de PostgreSQL en un servidor.
Puede usar cualquiera de estos comandos para crear, eliminar, enumerar y ver las propiedades de una base de datos en el servidor.
| Cmdlet | Uso | Descripción |
|---|---|---|
| az postgres db create | az postgres db create -g myresourcegroup -s mydemoserver -n mydatabasename |
Crea una base de datos. |
| az postgres db delete | az postgres db delete -g myresourcegroup -s mydemoserver -n mydatabasename |
Elimina la base de datos del servidor. Este comando no elimina el servidor. |
| az postgres db list | az postgres db list -g myresourcegroup -s mydemoserver |
Enumera todas las bases de datos del servidor. |
| az postgres db show | az postgres db show -g myresourcegroup -s mydemoserver -n mydatabasename |
Muestra más detalles de la base de datos. |
Actualización de la contraseña del administrador
La contraseña del rol Administrador se puede cambiar con este comando.
az postgres server update --resource-group myresourcegroup --name mydemoserver --admin-password <new-password>
Importante
Asegúrese de que tiene su longitud oscila entre 8 y 128 caracteres. Debe contener caracteres de tres de las categorías siguientes: Letras del alfabeto inglés mayúsculas y minúsculas, números y caracteres no alfanuméricos.
Eliminación de un servidor
Si solo quiere eliminar el Servidor único de PostgreSQL, puede ejecutar el comando az postgres server delete.
az postgres server delete --resource-group myresourcegroup --name mydemoserver