En esta página, se explica cómo importar metadatos a Dataproc Metastore servicio.
La función de importación de metadatos te permite rellenar un archivo servicio de Dataproc Metastore con metadatos que se almacenan en una de almacenamiento de Google.
Estos metadatos portátiles generalmente se exportan desde otro Servicio de Dataproc Metastore o desde Hive Metastore (HMS) autoadministrado.
Información acerca de la importación de metadatos
Puedes importar los siguientes formatos de archivo en Dataproc Metastore:
- Un conjunto de archivos Avro almacenados en una carpeta.
- Un único archivo de volcado de MySQL almacenado en una carpeta de Cloud Storage.
Los archivos MySQL o Avro que importes deben generarse desde una base en la base de datos.
Si tus archivos están en un formato diferente, como PostgreSQL, debes convertirlos en el formato Avro o MySQL. Después de la conversión, puedes importarlos Dataproc Metastore.
Avro
Las importaciones basadas en Avro solo son compatibles con las versiones 2.3.6 y 3.1.2 de Hive. Cuándo
importar archivos Avro, Dataproc Metastore espera una serie de
<table-name>.avro
para cada tabla de tu base de datos.
Para importar archivos Avro, tu servicio de Dataproc Metastore puede usar el tipo de base de datos de MySQL o Spanner.
MySQL
Las importaciones basadas en MySQL son compatibles con todas las versiones de Hive. Cuando importes MySQL , Dataproc Metastore espera un único archivo SQL que contenga toda la información de tu tabla. Los volcados de MySQL obtenidos de un clúster de Dataproc con SQL nativo se también es compatible.
Para importar archivos MySQL, tu servicio de Dataproc Metastore debe usar el tipo de base de datos de MySQL. El tipo de base de datos de Spanner no es compatible con MySQL .
Consideraciones de importación
La importación reemplaza todos los metadatos existentes almacenados en Servicio de Dataproc Metastore.
La función de importación de metadatos solo importa metadatos. Los datos que crea Apache Hive en tablas internas no se replica en la importación.
La importación no transforma el contenido de la base de datos ni controla el archivo. migración. Si mueves tus datos a una ubicación diferente, debes hacerlo manualmente actualizar las ubicaciones de los datos de tu tabla y el esquema en tu Servicio de Dataproc Metastore.
La importación no restablece ni reemplaza la IAM detallada y políticas de seguridad.
Si usas los Controles del servicio de VPC, solo puedes importar datos desde un bucket de Cloud Storage que resida en el mismo perímetro de servicio que el servicio de Dataproc Metastore.
Antes de comenzar
- Habilita Dataproc Metastore en tu proyecto.
- Comprende los requisitos de red específicos de tu proyecto.
- Crea un servicio de Dataproc Metastore.
Roles obligatorios
A fin de obtener los permisos que necesitas para importar metadatos en Dataproc Metastore, solicita a tu administrador que te otorgue el los siguientes roles de IAM:
-
Para importar metadatos, sigue estos pasos:
-
Editor de Dataproc Metastore (
roles/metastore.editor
) en el servicio de metadatos. -
Administrador de Dataproc Metastore (
roles/metastore.admin
) en el proyecto.
-
Editor de Dataproc Metastore (
-
En MySQL, usa el objeto de Cloud Storage (archivo de volcado de SQL) para importar:
Otorgar a tu cuenta de usuario y al agente de servicio de Dataproc Metastore el rol de visualizador de objetos de Storage (
roles/storage.objectViewer
) en el bucket de Cloud Storage que contiene el volcado de metadatos que se está importando. -
En Avro, si quieres usar el bucket de Cloud Storage para importar, haz lo siguiente:
Otorgar a tu cuenta de usuario y al agente de servicio de Dataproc Metastore el rol de visualizador de objetos de Storage (
roles/storage.objectViewer
) en el bucket de Cloud Storage que contiene el volcado de metadatos que se está importando.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
Estos roles predefinidos contienen los permisos necesarios para importar metadatos en Dataproc Metastore. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para importar metadatos a Dataproc Metastore:
-
Para importar metadatos, sigue estos pasos:
metastore.imports.create
en el servicio de almacén de metadatos. -
En el caso de MySQL, para usar el objeto de Cloud Storage (archivo de volcado de SQL) para la importación, otorga a tu cuenta de usuario y al agente de servicio de Dataproc Metastore:
storage.objects.get
en el bucket de Cloud Storage que contiene el volcado de metadatos que se está importando. -
Para que Avro use el bucket de Cloud Storage para importar, otorga a tu cuenta de usuario y al agente de servicio de Dataproc Metastore:
storage.objects.get
en el bucket de Cloud Storage que contiene el volcado de metadatos que se está importando.
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos
Para obtener más información sobre roles y permisos específicos de Dataproc Metastore, consulta Descripción general de IAM de Dataproc Metastore.Importa tus metadatos
La operación de importación consta de un proceso de dos pasos. Primero, prepara tus archivos de importación y, luego, los importes a Dataproc Metastore.
Cuando inicias una importación, Dataproc Metastore realiza la validación del esquema de metadatos. Esta validación verifica las tablas en el volcado de SQL y los nombres de archivo de Avro. Si falta una tabla, la importación falla con un con un mensaje de error que describe la tabla faltante.
Para comprobar la compatibilidad de los metadatos de Hive antes de una importación, puedes usar el Dataproc Metastore Kit de herramientas.
Prepara los archivos de importación antes de importarlos
Antes de importar tus archivos a Dataproc Metastore, debes debes copiar tus archivos de volcado de metadatos en Cloud Storage, como tu artefactos de Cloud Storage bucket.
Mueve tus archivos a Cloud Storage
Crea un volcado de la base de datos externa a la que deseas importar Dataproc Metastore.
Si quieres obtener instrucciones para crear un volcado de la base de datos, consulta las siguientes páginas:
Sube los archivos a Cloud Storage.
Asegúrate de anotar la ruta de acceso de Cloud Storage a la que subes tus archivos , deberás usarlo más adelante para realizar la importación.
Si importas archivos de MySQL, sube el archivo SQL a un Bucket de Cloud Storage.
Si importas archivos Avro, súbelos a una Carpeta de Cloud Storage.
- Tu importación de Avro debe incluir un archivo Avro para cada tabla de Hive, incluso si la tabla está vacía.
- Los nombres de los archivos Avro deben seguir el formato
<table-name>.avro
. El<table-name>
debe tener todo en mayúsculas. Por ejemplo,AUX_TABLE.avro
.
Importa los archivos a Dataproc Metastore
Antes de importar metadatos, revisa el artículo y consideraciones clave.
Mientras se ejecuta una importación, no puedes actualizar Dataproc Metastore servicio, como cambiar los parámetros de configuración. Sin embargo, puedes lo usarás para operaciones normales, como acceder a los metadatos desde Dataproc conectado o clústeres autoadministrados.
Console
En la consola de Google Cloud, abre la página Dataproc Metastore:
En la página Dataproc Metastore, haz clic en el nombre del servicio. en las que quieres importar metadatos.
Se abrirá la página Detalle del servicio.
Figura 1: Dataproc Metastore Página de detalles del servicio En la barra de navegación, haz clic en Importar.
Se abrirá el diálogo Import.
Ingresa el nombre de importación.
En la sección Destino, elige MySQL o Avro.
En el campo URI de destino, haz clic en Explorar y selecciona el URI de Cloud Storage en el que deseas importarás tus archivos.
También puedes ingresar la ubicación de tu bucket de forma manual en el campo de texto proporcionado. Usa el siguiente formato:
bucket/object
obucket/folder/object
.Opcional: Ingresa una descripción de la importación.
Puedes editar la descripción en la página Detalles del servicio.
Para actualizar el servicio, haz clic en Importar.
Cuando se complete la importación, aparecerá en una tabla en la página Detalles del servicio de la pestaña Importar/Exportar.
gcloud CLI
Para importar metadatos, ejecuta el siguiente comando
gcloud metastore services import gcs
. :gcloud metastore services import gcs SERVICE_ID \ --location=LOCATION \ --import-id=IMPORT_ID \ --description=DESCRIPTION \ --dump-type=DUMP_TYPE \ --database-dump=DATABASE_DUMP
Reemplaza lo siguiente:
SERVICE_ID
: Es el ID o el nombre completamente calificado de tu servicio de Dataproc Metastore.LOCATION
: Es la región de Google Cloud en la que reside tu servicio de Dataproc Metastore.IMPORT_ID
: Es un ID o nombre completamente calificado para la importación de metadatos. Por ejemplo,import1
DESCRIPTION
: Es una descripción de tu importación (opcional). Puedes editarla más tarde congcloud metastore services imports update IMPORT
.DUMP_TYPE
: Es el tipo de base de datos externa que estás importando. Los valores aceptados sonmysql
yavro
. El valor predeterminado esmysql
.DATABASE_DUMP
: Es la ruta de acceso a Cloud Storage que contiene el archivos de base de datos. Esta ruta de acceso debe comenzar congs://
. En Avro, proporciona la ruta de acceso a la carpeta en la que se almacenan los archivos Avro (la carpeta de Cloud Storage). En el caso de MySQL, proporciona la ruta de acceso al archivo MySQL (el objeto de Cloud Storage).
Verifica que la importación se haya realizado correctamente.
REST
Sigue las instrucciones de la API para importar metadatos a un servicio con el Explorador de API.
Con la API, puedes crear, enumerar, describir y actualizar importaciones, pero no puedes borrar importaciones. Sin embargo, si borras un servicio de Dataproc Metastore, se borran todos los datos anidados almacenados. .
Cuando la importación se realiza correctamente, Dataproc Metastore vuelve automáticamente al estado activo. Si la importación falla, Dataproc Metastore revierte a su estado correcto anterior.
Ver historial de importaciones
Para ver el historial de importaciones de un servicio de Dataproc Metastore en la consola de Google Cloud, completa los siguientes pasos:
- En la consola de Google Cloud, abre la página Dataproc Metastore.
En la barra de navegación, haz clic en Importar/Exportar.
Tu historial de importaciones aparece en la tabla Historial de importaciones.
El historial muestra hasta las últimas 25 importaciones.
Si borras un servicio de Dataproc Metastore, también se borrará todo el historial de importaciones asociado.
Soluciona los problemas comunes.
Estos son algunos problemas habituales:
- La importación falla porque las versiones de Hive no coinciden.
- El agente de servicio o la cuenta de usuario no tienen los permisos necesarios.
- El trabajo falla porque el archivo de la base de datos es demasiado grande.
Si necesitas más ayuda para resolver problemas comunes, consulta Situaciones de error de importación y exportación.