Puede importar todos los artefactos de gobernanza de una instancia de IBM Knowledge Catalog con un archivo ZIP que haya creado exportando los artefactos.
Puede utilizar este método para mover artefactos de gobernanza de una instancia de IBM Knowledge Catalog a otra o para editar las propiedades de los artefactos de gobernanza con una herramienta externa. Todos los artefactos importados se publican inmediatamente sin flujo de trabajo.
- Requisitos previos
- Edición del contenido del archivo ZIP
- Preparación de la importación de un archivo ZIP
- Opciones de fusión
- Importación de un archivo ZIP
- Supervisión del proceso de importación
- Limpieza de un proceso de importación detenido
Requisitos previos
Antes de importar artefactos de gobernabilidad con un archivo ZIP, cree el archivo con el formato correcto y asegúrese de que tiene los permisos necesarios.
Archivo zip
Debe tener un archivo ZIP de artefactos exportados que ha creado con la solicitud de API de GET /v3/governance_artifact_types/{artifact_type}/export . El tamaño máximo del archivo ZIP es de 2 GB. Consulte Exportación de todos los artefactos de gobernabilidad a un archivo ZIP.
Permisos
Debe tener el permiso de usuario Gestionar glosario .
No es necesario que sea un colaborador en ninguna de las categorías creadas o afectadas por el proceso de importación.
Edición del contenido del archivo ZIP
El archivo ZIP exportado contiene una carpeta independiente para cada tipo de artefacto con un archivo CSV que contiene ese tipo de artefacto.
Puede modificar el contenido del archivo ZIP exportado manualmente. Siga estas directrices:
- No cree carpetas adicionales, por ejemplo, una carpeta padre.
- No cambie los nombres de carpeta. Las carpetas para cada tipo de artefacto en el archivo ZIP deben tener los nombres siguientes:
category,classification,data_class,glossary_term,policy,ruleyreference_data. - Mantenga el formato correcto de cada archivo CSV. Consulte Formato de archivo CSV para importar artefactos de gobernabilidad.
- No elimine ni cambie el nombre de la columna
Artifact IDen cada archivo CSV. Esta columna especifica el identificador del artefacto además del nombre del artefacto. - Defina una relación entre dos artefactos de gobernabilidad sólo para uno de los artefactos. Hay dos excepciones:
- La relación es entre una política y una regla de gobierno. En este caso, defina la relación para ambos artefactos en ambos archivos CSV. En el archivo CSV con políticas, añada la relación en la columna
Rule. En el archivo CSV con reglas de gobierno, añada la relación en la columnaParent Policies. - Está utilizando la opción de fusión
all. En este caso, debe asegurarse de que todo el contenido CSV sea coherente con respecto a las relaciones entre artefactos. Por ejemplo, si el archivo de importación ZIP contiene un término y una clase de datos conectados junto con una relación, esta relación debe estar presente en CSV de clases de datos y CSV de términos. De lo contrario, el comportamiento de importación de la relación es imprevisible, la relación se puede importar o no.
- La relación es entre una política y una regla de gobierno. En este caso, defina la relación para ambos artefactos en ambos archivos CSV. En el archivo CSV con políticas, añada la relación en la columna
Preparación para importar un archivo ZIP
Antes de importar un archivo ZIP, debe completar las tareas siguientes:
- Realice la acción adecuada para evitar artefactos predefinidos duplicados
- Crear propiedades y relaciones personalizadas
Evitar artefactos predefinidos duplicados
Los artefactos de los archivos ZIP exportados se identifican con identificadores de artefacto en la columna Artifact ID , en lugar de mediante el nombre de artefacto y la vía de acceso de categoría. Sin embargo, los identificadores de artefactos para términos empresariales predefinidos, clases de datos y clasificaciones difieren entre cada instancia de IBM Knowledge Catalog. Por lo tanto, los términos de negocio predefinidos importados, las clases de datos y las clasificaciones no se reconocen como los mismos que los términos de negocio predefinidos, las clases de datos y las clasificaciones existentes. Como resultado, el proceso de importación crea artefactos duplicados.
Puede evitar los artefactos prefinados duplicados con uno de los métodos siguientes:
Elimine los artefactos predefinidos existentes de la instancia de IBM Knowledge Catalog de destino antes de importar artefactos. Consulte Supresión de artefactos publicados del mismo tipo.
Para clases de datos y clasificaciones predefinidas:
- Excluya la categoría [sin categorizar] cuando cree el archivo ZIP exportando artefactos.
- Edite los archivos CSV para las clases de datos y clasificaciones y sustituya los identificadores de artefacto para las clases de datos y clasificaciones predefinidas en las columnas Clasificación padre y Clase de datos padre por los nombres de artefacto predefinidos equivalentes y las vías de acceso de categoría.
- Edite los archivos CSV para otros artefactos y sustituya los identificadores de artefacto para las clases de datos y clasificaciones predefinidas por los nombres de artefacto predefinidos equivalentes y las vías de acceso de categoría en las columnas Clasificaciones y Clases de datos , para cualquier artefacto que tenga relaciones con los artefactos predefinidos.
Al importar los artefactos, se crean las relaciones con los artefactos predefinidos de destino existentes.
Para términos empresariales predefinidos:
- Excluya la categoría Datos personales de ejemplo de Knowledge Accelerator cuando cree el archivo ZIP exportando artefactos.
- Edite los archivos CSV para termsa de negocio y otros artefactos y sustituya los identificadores de artefacto para términos de negocio predefinidos por los nombres de artefacto predefinidos equivalentes y las vías de acceso de categoría en la columna Términos relacionados y en cualquier otra columna que defina relaciones de términos de negocio.
Al importar los artefactos, se crean las relaciones con los artefactos predefinidos de destino existentes.
Los conjuntos de datos de referencia predefinidos de la categoría Ubicaciones tienen los mismos valores de ID de artefacto en todas las instancias de IBM Knowledge Catalog.
Crear propiedades y relaciones personalizadas
Debe crear cada propiedad personalizada o definición de relación manualmente antes de importar el archivo ZIP. De lo contrario, la propiedad personalizada y los valores de relación no se importan.
Para obtener más información, consulte Propiedades personalizadas y relaciones.
Opciones de fusión
Las siguientes opciones de fusión están disponibles al ejecutar la importación ZIP:
all- Sustituir todos los valores. Los valores importados sustituyen a los valores existentes en un catálogo.
specified- Sustituir por valores definidos. Los valores importados que no están vacíos sustituyen a los valores existentes en un catálogo.
empty- Sustituya los valores vacíos. Los valores importados sólo sustituyen a los valores vacíos de un catálogo.
specified se utiliza como valor predeterminado.
Al importar archivos que contienen valores de datos de referencia, siempre debe utilizar merge_option=all.
Para obtener más información sobre las opciones de fusión, consulte Métodos para fusionar artefactos importados y existentes
Importación de un archivo ZIP
Para importar un archivo ZIP de artefactos de gobernabilidad:
- Si es necesario, suprima los artefactos predefinidos existentes o edite las relaciones con los artefactos predefinidos. Consulte Preparación para importar un archivo ZIP.
- Envíe la solicitud
POST /v3/governance_artifact_types/import. Incluya la opción de fusión y la vía de acceso al archivo ZIP. Consulte Documentación de la API: Importar valores del archivo ZIP especificado. Todos los artefactos se publican inmediatamente sin flujo de trabajo. - Cuando finalice el proceso de importación, añada otros colaboradores a las nuevas categorías. Consulte Gestión de colaboradores de categoría.
Debe esperar hasta que finalice el proceso de importación, o limpiar el proceso detenido, para poder iniciar un nuevo proceso de importación.
Supervisión del proceso de importación
Después de enviar la solicitud para importar el archivo ZIP, se proporciona un ID de proceso en la respuesta (parámetroprocess_id ). Puede utilizar el ID de proceso para comprobar el estado de la importación. Envíe una solicitud GET /v3/governance_artifact_types/import/status/{process_id} para consultar el estado de la importación. Consulte la documentación de la API: Estado de la importación.
Limpieza de un proceso de importación detenido
Experimental Este es un release experimental y aún no recibe soporte para su uso en entornos de producción.
Si la importación se para, puede limpiar el proceso de importación y, a continuación, volver a importar el archivo ZIP. No puede iniciar un nuevo proceso de importación hasta que se complete el anterior o hasta que se limpie el proceso estancado. Todos los procesos de importación se limpian automáticamente después de 24 horas de inactividad.
Puede comprobar el estado del proceso de importación enviando una solicitud GET /v3/governance_artifact_types/import/status/{process_id} . El proceso se ha detenido si el estado es IN_PROGRESS, pero los artefactos no se están importando.
Para limpiar un proceso de importación detenido o fallido, envíe la solicitud POST /v3/governance_artifact_types/import/cleanup/{process_id} .
Consulte la documentación de la API: Limpiar el proceso de importación ZIP.
Más información
Importación de artefactos de gobernabilidad con un archivo CSV
Exportación de todos los artefactos de gobierno a un archivo ZIP
Resolución de problemas de importación de artefactos de gobernabilidad
Documentación de la API: Importar valores del archivo ZIP especificado
Tema padre: Importar métodos para artefactos de gobernabilidad