{"id":10577,"date":"2021-02-16T09:00:15","date_gmt":"2021-02-16T17:00:15","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=10577"},"modified":"2021-02-10T06:05:47","modified_gmt":"2021-02-10T14:05:47","slug":"hands-on-migration-from-relational-to-collections","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/es\/hands-on-migration-from-relational-to-collections\/","title":{"rendered":"Migraci\u00f3n pr\u00e1ctica de sistemas relacionales a colecciones"},"content":{"rendered":"

El principal objetivo de este blog es ense\u00f1arte c\u00f3mo puedes migrar f\u00e1cilmente tus datos relacionales a Couchbase, reduciendo tu coste total de propiedad y potenciando tu plataforma de datos para responder a los r\u00e1pidos ciclos de publicaci\u00f3n que conocemos y amamos. Mientras migras puedes incluso conservar los nombres\/espacios de claves individuales que ya tienes estructurados usando \u00e1mbitos y colecciones. Este blog es una especie de amalgama de las nuevas caracter\u00edsticas explicadas en otros blogs y actualizaciones recientes, pero a diferencia de esos blogs incluye algunos ejemplos de c\u00f3mo puedes migrar tus datos relacionales a Couchbase.<\/p>\n

Una de las cosas brillantes de Couchbase es que realmente escuchamos las necesidades de nuestra comunidad y continuamos desarrollando nuestros productos para ofrecer la mejor experiencia posible a nuestros clientes. Escrib\u00ed este blog como \"pr\u00e1ctico\" si quieres seguirlo, pero tambi\u00e9n puedes saltarte el paso de extracci\u00f3n y simplemente trabajar con un TSV que te he proporcionado.<\/p>\n

Si nos est\u00e1s siguiendo, los prerrequisitos son un RDBMS del que extraer datos, un int\u00e9rprete de python y un servidor Couchbase (ya sea en Docker, VM, f\u00edsico, etc.).<\/p>\n

Voy a utilizar un ejemplo en l\u00ednea para nuestra base de datos de demostraci\u00f3n. Enlace aqu\u00ed<\/a> es la base de datos de ejemplo con tres tablas: clientes, agentes y pedidos.<\/p>\n

Migrar datos a Couchbase es realmente f\u00e1cil, vamos a imitar nuestra estructura de tablas utilizando nuestra nueva funci\u00f3n de \u00e1mbitos y colecciones. Para empezar necesitamos un espacio de almacenamiento l\u00f3gico, en este ejemplo estamos utilizando un bucket por base de datos, por lo que s\u00f3lo tenemos que crear un bucket. El esquema se asignar\u00e1 a un \u00e1mbito, as\u00ed que un \u00e1mbito. Por \u00faltimo, cada una de las tablas se asignar\u00e1 a una colecci\u00f3n del mismo nombre, por lo que habr\u00e1 un total de tres colecciones.<\/p>\n

\"\"<\/p>\n

Creaci\u00f3n de cubos, \u00e1mbitos y colecciones:<\/b><\/p>\n

Tenemos muchas opciones disponibles aqu\u00ed. El SDK, REST API, Couchbase CLI (sin olvidar Couchbase shell), y Web GUI. Voy a utilizar la API REST, la belleza aqu\u00ed es que podemos acceder a ella desde la l\u00ednea de comandos, \u00a1y no hay necesidad de instalar nada! Para cualquier persona t\u00edmida de la interfaz REST, la documentaci\u00f3n aqu\u00ed<\/a> explicar\u00e1 otros m\u00e9todos alternativos.<\/p>\n

Los pasos siguientes especificar\u00e1n los comandos necesarios para configurar su cubo, \u00e1mbito y colecciones:<\/p>\n

Ejecute los dos comandos siguientes para crear su cubo de datos y su \u00e1mbito:<\/p>\n

curl -X POST -u Administrator:password https:\/\/127.0.0.1:8091\/pools\/default\/buckets -d name=migration -d bucketType=couchbase -d ramQuotaMB=100\r\ncurl -X POST -u Administrator:password https:\/\/127.0.0.1:8091\/pools\/default\/buckets\/migration\/collections<\/a> -d name=reference<\/pre>\n
Ahora cree las tres colecciones a las que asignaremos los datos de nuestra tabla:<\/p>\n
curl -u Administrator:password -X POST https:\/\/localhost:8091\/pools\/default\/buckets\/migration\/collections\/reference -d name=$TABLE_NAME<\/pre>\n
Simplemente cambie la variable $TABLE_NAME seg\u00fan sea necesario para crear las colecciones de agentes, pedidos y clientes respectivamente.<\/p>\n
(En el Ap\u00e9ndice encontrar\u00e1 enlaces a las p\u00e1ginas de documentaci\u00f3n de estas API).<\/p>\n
Con todo creado, dir\u00edgete a la secci\u00f3n Buckets y haz clic en el enlace \"Scopes & Collections\" junto al nombre del bucket que has creado, el m\u00edo se llama migration. Si expandes el \u00e1mbito que hemos creado, ver\u00e1s las tres colecciones que hemos creado.<\/p>\n
\"\"<\/p>\n
 <\/p>\n
Extracci\u00f3n de datos de nuestro RDBMS<\/strong><\/p>\n
Ahora que tenemos nuestro cubo, \u00e1mbito y colecciones en su lugar, estamos listos para exportar nuestros datos relacionales. He escrito un gui\u00f3n corto<\/a> que extrae los datos almacenados en la base de datos MySQL de ejemplo a TSV, que es felizmente soportado por nuestras herramientas de importaci\u00f3n, o puede exportar los datos usted mismo. Si ya tiene la base de datos configurada, simplemente ejecute el script y cambie las variables para utilizar el nombre de usuario y la contrase\u00f1a que configur\u00f3. Despu\u00e9s de ejecutar el script, deber\u00eda ver tres archivos .tsv creados que contienen los datos de cada tabla de la base de datos de ejemplo.<\/p>\n
#!\/usr\/bin\/python3\r\n\r\nimport subprocess\r\nimport json\r\nimport re\r\n\r\nsql_commands='{ \"commands\": { \"agents\": \"SELECT * FROM agents;\", \"customer\": \"SELECT * FROM customer\", \"orders\": \"SELECT * FROM orders;\" } }'\r\ndb_name = \"sample\"\r\nusername = \"root\"\r\npassword = \"rootroot\"\r\n\r\nsql_commands = json.loads(sql_commands)\r\nfor command_name in sql_commands[\"commands\"]:\r\n    print(\"Running command: \" + command_name)\r\n    \r\n    sql_statement = \"--execute={0}\".format(sql_commands[\"commands\"][command_name])\r\n    command = subprocess.run([\"\/usr\/local\/mysql\/bin\/mysql\", db_name, \"--user={0}\".format(username), \"--password={0}\".format(password), sql_statement], capture_output=True)\r\n    with open(command_name+\"_out.tsv\", 'w') as command_output_file:\r\n        command_without_trailing_white_space = re.sub(b\" +\\\\t\", b'\\\\t', command.stdout)\r\n        command_output_file.write(command_without_trailing_white_space.decode('ascii'))<\/pre>\n
Aqu\u00ed tienes un ejemplo de la salida TSV, si s\u00f3lo est\u00e1s trabajando en la parte de importaci\u00f3n, sigue adelante y utiliza esto:<\/p>\n
AGENT_CODE AGENT_NAME WORKING_AREA COMMISSION PHONE_NO COUNTRY\r\nA007 Ramasundar Bangalore 0.15 077-25814763\r\nA003 Alex London 0.13 075-12458969\r\nA008 Alford New York 0.12 044-25874365\r\nA011 Ravi Kumar Bangalore 0.15 077-45625874\r\nA010 Santakumar Chennai 0.14 007-22388644\r\nA012 Lucida San Jose 0.12 044-52981425\r\nA005 Anderson Brisban 0.13 045-21447739\r\nA001 Subbarao Bangalore 0.14 077-12346674\r\nA002 Mukesh Mumbai 0.11 029-12358964\r\nA006 McDen London 0.15 078-22255588\r\nA004 Ivan Torento 0.15 008-22544166\r\nA009 Benjamin Hampshair 0.11 008-22536178<\/pre>\n
 <\/p>\n
Importaci\u00f3n de datos a Couchbase<\/strong><\/p>\n
Nuestra herramienta de importaci\u00f3n, cbimport, facilita enormemente la importaci\u00f3n de datos en muchos formatos. Recientemente hemos implementado algunas funcionalidades de importaci\u00f3n en nuestra web gui, haciendo el proceso a\u00fan m\u00e1s accesible. A continuaci\u00f3n se muestra una captura de pantalla de nuestra herramienta de importaci\u00f3n Web Gui. Para llegar aqu\u00ed ingresa a la GUI Web de Couchbase, luego ve a \"Documentos\" -> \"Importar\".<\/p>\n
\"\"<\/p>\n
Aqu\u00ed vamos a importar nuestros TSV utilizando el bot\u00f3n \"Seleccionar archivo para importar\", observe que al cargar un archivo, muchos campos se rellenan por usted. Eche un vistazo a los datos importados y aseg\u00farese de que se corresponden con lo que espera teniendo en cuenta la estructura relacional anterior. S\u00f3lo tenemos que completar unos pocos pasos para importar nuestros datos.<\/p>\n
En primer lugar, especifica una colecci\u00f3n a la que importar los datos, por ejemplo, agents_out.tsv se asigna a la colecci\u00f3n 'agents'. Tambi\u00e9n vamos a hacer corresponder las filas individuales de nuestra base de datos relacional anterior con IDs de documentos en Couchbase, de nuevo esto se hace f\u00e1cilmente con nuestra herramienta de importaci\u00f3n utilizando la secci\u00f3n \"Importar con ID de documento\". A lo largo de mis importaciones de datos he utilizado la clave primaria de los datos relacionales como el ID del documento en Couchbase, esto es realmente \u00fatil ya que cada clave en una colecci\u00f3n debe ser \u00fanica. Por ejemplo, en el archivo agents_out.tsv he utilizado la clave primaria \"AGENT_CODE\". Realice este paso para cada uno de los .tsv; agentes, pedidos y clientes.<\/p>\n
 <\/p>\n
Y ah\u00ed lo tienen, para recapitular, hemos hecho lo siguiente:<\/p>\n
    \n
  1. Exportaci\u00f3n de los datos de nuestra base de datos heredada a TSV<\/li>\n
  2. Creado un \u00e1mbito, y colecciones basadas en las tablas que estamos importando<\/li>\n
  3. Importar los datos utilizando la herramienta de migraci\u00f3n de datos a una colecci\u00f3n espec\u00edfica, dentro de un \u00e1mbito.<\/li>\n<\/ol>\n
    Vale, ahora que tengo mis datos en Couchbase, \u00bfnecesito aprender una nueva forma de consultar datos? Todo lo contrario, \u00bfpor qu\u00e9 no te diriges a la GUI web de Couchbase, y consultas algunos de tus datos reci\u00e9n importados usando N1QL? Es compatible con SQL++ y, si alguna vez ha escrito una consulta SQL, se sentir\u00e1 como en casa.<\/a>La puerta est\u00e1 abierta, \u00a1entra! No s\u00f3lo le facilitaremos la redacci\u00f3n de consultas, sino que incluso le ayudaremos a crear el \u00edndice adecuado con nuestro Servicio Index Advisor<\/a>S\u00f3lo tiene que introducir la consulta que desea realizar y el asesor le sugerir\u00e1 un \u00edndice. Incluso soportamos JOIN's:<\/p>\n
    SELECT orders.AGENT_CODE, orders.ORD_AMOUNT, agents.AGENT_NAME\r\nFROM `bigdata`.reference.orders as orders\r\nJOIN `bigdata`.reference.agents as agents\r\nON orders.AGENT_CODE = meta(agents).id;<\/pre>\n
    Este es un gran comienzo en la direcci\u00f3n correcta para la transici\u00f3n de relacional a NoSQL, si quieres aprender m\u00e1s sobre el modelado de tus datos para sacar el m\u00e1ximo provecho de Couchbase, consulte nuestra gu\u00eda de modelado de datos<\/a>.<\/p>\n
    \u00bfQuiere saber m\u00e1s sobre \u00e1mbitos y colecciones? Recomiendo el blog de Shivani<\/a><\/p>\n
     <\/p>\n
    Ap\u00e9ndice:<\/b><\/p>\n