El flujo de MysqlDump | Documentación de cPanel y WHM

El flujo de MysqlDump

Válido para las versiones 82 a 86


Última modificación: 30 de julio de 2021

Visión general

Advertencia:

La secuencia de MysqlDump es experimental. El comportamiento de este punto final puede cambiar en una versión futura de cPanel & WHM.

El flujo de MysqlDump le permite producir un volcado de una base de datos MySQL® a través de WebSocket desde cualquier computadora que tenga acceso al servidor. No es necesario que inicie sesión en su servidor. Usted puede ejecutar un comando para solicitar que su servidor le envíe la salida de volcado. A continuación, puede utilizar la salida de volcado para crear una copia de seguridad.

Usando el flujo de MysqlDump

Para transmitir una salida de volcado desde cPanel, llámelo a través de cualquier WebSocket cliente. También necesitará un token de API o autenticarse con autenticación HTTP básica para usar el punto final.

Usar autenticación HTTP básica

Para utilizar la autenticación HTTP básica, siga las instrucciones de nuestra Guía de autenticación de API: autenticación de nombre de usuario y contraseña documentación. Para obtener más información sobre la autenticación HTTP básica, lea el RFC 7617 documentación.

Genera un token de API en cPanel

Para generar un token de API de cPanel, use cPanel’s Administrar tokens de API interfaz (cPanel >> Inicio >> Seguridad >> Administrar tokens API). También puede utilizar la UAPI Tokens::create_full_access función. Para obtener más información, lea nuestro Cómo utilizar los tokens de la API de cPanel documentación.

Parámetros de MysqlDump

usted debe utilice los siguientes parámetros:

Parámetros Descripción Ejemplo
dbname El nombre de la base de datos que se va a volcar. dbname=username_example_db
encoding El valor para dar el juego de caracteres predeterminado de MySQL. Valores posibles:

Nota:

Te recomendamos que corras utf8mb4y solo corre utf8 si experimenta un error de clasificación.

encoding=utf8mb4
include_data Un valor booleano que indica si se deben incluir datos de la tabla en el volcado. include_data=1

Importante:

Utilizar el --no-tablespaces opción si lo haces no necesita transmitir información de espacio de tabla y recibir el siguiente error:

Incompatible Change: Access to the INFORMATION_SCHEMA.FILES table now requires the PROCESS privilege.

El marco cerrado de WebSocket incluirá uno de los siguientes códigos de estado:

los 1011 y 4000 los códigos de error contienen un ID de error. Puedes buscar el /usr/local/cpanel/logs/error_log para encontrar más información sobre por qué falló el comando.

Ejemplo

Para transmitir una salida de volcado de cPanel MySQL a través del npm wscat2 utilidad, ejecute el siguiente comando:

wscat -H 'Authorization: cpanel username:GG24IS0019Q8SGI6R5EATJHLMBY3UX6Z' -c 'wss://example.com:2083/websocket/MysqlDump?dbname=username_db1&include_data=1&encoding=utf8mb4' > /$PATH/file.sql

En este ejemplo:

  • username representa el nombre de usuario de la cuenta.

  • GG24IS0019Q8SGI6R5EATJHLMBY3UX6Z representa el Token de API de cPanel.

  • example.com representa cualquier nombre en DNS que se resuelve en el servidor.

  • username_db1 representa el nombre de la base de datos.

  • /$PATH/file.sql representa el directorio y el nombre de archivo de la salida de volcado.

El comando producirá un resultado similar al siguiente ejemplo:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
-- MySQL dump 10.13 Distrib 5.7.25, for Linux (x86_64)
--
-- Host: localhost Database: username_db1
-- ------------------------------------------------------
-- Server version 5.7.26

/*!40101 SET @OLD_CHARACTER_SET_CLIENT=@@CHARACTER_SET_CLIENT */;
/*!40101 SET @OLD_CHARACTER_SET_RESULTS=@@CHARACTER_SET_RESULTS */;
/*!40101 SET @OLD_COLLATION_CONNECTION=@@COLLATION_CONNECTION */;
/*!40101 SET NAMES utf8mb4 */;
/*!40103 SET @OLD_TIME_ZONE=@@TIME_ZONE */;
/*!40103 SET TIME_ZONE='+00:00' */;
/*!40014 SET @OLD_UNIQUE_CHECKS=@@UNIQUE_CHECKS, UNIQUE_CHECKS=0 */;
/*!40014 SET @OLD_FOREIGN_KEY_CHECKS=@@FOREIGN_KEY_CHECKS, FOREIGN_KEY_CHECKS=0 */;
/*!40101 SET @OLD_SQL_MODE=@@SQL_MODE, SQL_MODE='NO_AUTO_VALUE_ON_ZERO' */;
/*!40111 SET @OLD_SQL_NOTES=@@SQL_NOTES, SQL_NOTES=0 */;

--
-- Current Database: `username_db1`
--

CREATE DATABASE /*!32312 IF NOT EXISTS*/ `username_db1` /*!40100 DEFAULT CHARACTER SET latin1 */;

USE `username_db1`;

--
-- Table structure for table `example`
--

DROP TABLE IF EXISTS `example`;
/*!40101 SET @saved_cs_client = @@character_set_client */;
/*!40101 SET character_set_client = utf8 */;
CREATE TABLE `example` (
`id` smallint(5) unsigned NOT NULL AUTO_INCREMENT,
`name` varchar(20) NOT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM AUTO_INCREMENT=2 DEFAULT CHARSET=latin1;
/*!40101 SET character_set_client = @saved_cs_client */;

--
-- Dumping data for table `example`
--

LOCK TABLES `example` WRITE;
/*!40000 ALTER TABLE `example` DISABLE KEYS */;
INSERT INTO `example` (`id`, `name`) VALUES (1,'Sample data');
/*!40000 ALTER TABLE `example` ENABLE KEYS */;
UNLOCK TABLES;

--
-- Dumping events for database 'username_db1'
--

--
-- Dumping routines for database 'username_db1'
--
/*!40103 SET TIME_ZONE=@OLD_TIME_ZONE */;

/*!40101 SET SQL_MODE=@OLD_SQL_MODE */;
/*!40014 SET FOREIGN_KEY_CHECKS=@OLD_FOREIGN_KEY_CHECKS */;
/*!40014 SET UNIQUE_CHECKS=@OLD_UNIQUE_CHECKS */;
/*!40101 SET CHARACTER_SET_CLIENT=@OLD_CHARACTER_SET_CLIENT */;
/*!40101 SET CHARACTER_SET_RESULTS=@OLD_CHARACTER_SET_RESULTS */;
/*!40101 SET COLLATION_CONNECTION=@OLD_COLLATION_CONNECTION */;
/*!40111 SET SQL_NOTES=@OLD_SQL_NOTES */;

-- Dump completed on 2019-07-10 9:07:57
1000:

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *