Puede importar artefactos de gobernabilidad con un archivo. Puede importar un tipo de artefacto de gobernanza a la vez o importar todos los artefactos de gobernanza de otra instancia de IBM Knowledge Catalog.
- Compatibilidad entre entornos de despliegue
- Comparación de métodos de importación
- Artefactos de gobernabilidad que puede importar
- Métodos para fusionar artefactos importados y existentes
- Consideraciones acerca de la seguridad
Compatibilidad entre entornos de despliegue
Puede exportar y, a continuación, importar artefactos de gobernanza entre instancias de IBM Knowledge Catalog en los siguientes entornos de despliegue:
- Cloud Pak for Data 3.5
- Cloud Pak for Data 4.x
- Cloud Pak for Data as a Service
Los valores de los Stewards no son compatibles entre las instancias de IBM Knowledge Catalog Cloud Pak for Data as a Service y Cloud Pak for Data 3.5 o 4.x.
Puede importar artefactos de gobierno de IBM InfoSphere Information Governance Catalog a instancias de IBM Knowledge Catalog en Cloud Pak for Data 3.5 y 4.x. Para importar artefactos de gobierno desde IBM InfoSphere Information Governance Catalog a instancias de IBM Knowledge Catalog en Cloud Pak for Data as a Service, debe editar cada archivo CSV para que se ajuste al formato de los archivos CSV de artefactos de IBM Knowledge Catalog. Por ejemplo, es posible que tenga que realizar los siguientes tipos de ediciones:
- Eliminar columnas no soportadas
- Separe distintos tipos de artefacto en varios archivos CSV
- Modificar columnas soportadas
- Añadir columnas necesarias
Comparación de métodos de importación
Elija el método de importación adecuado para sus objetivos y circunstancias.
- Importar un único tipo de artefacto
Puede importar un único tipo de artefacto de gobernabilidad a la vez con un archivo CSV.
Este método es útil en los siguientes tipos de circunstancias:
- Desea que los artefactos importados estén sujetos al flujo de trabajo.
- Desea añadir valores para una propiedad a un tipo de artefacto de gobernabilidad. Exporte ese tipo de artefacto como un archivo CSV, edite el archivo CSV y, a continuación, impórtelo. Por ejemplo, puede utilizar este método para añadir un atributo personalizado a los términos empresariales.
- Desea definir artefactos en otro programa. Cree archivos CSV para cada tipo de artefacto. Por ejemplo, puede utilizar este método para definir artefactos en un programa de hoja de cálculo y, a continuación, importarlos.
Consulte Importación de artefactos de gobernabilidad por tipo con archivos CSV y Formato de archivo CSV para importar artefactos de gobernabilidad.
- Importar varios tipos de artefactos
Puede importar varios tipos de artefactos de gobernanza con un archivo ZIP que haya creado exportando varios tipos de artefactos de gobernanza existentes desde una instancia de IBM Knowledge Catalog. El archivo ZIP contiene archivos CSV para categorías y cada tipo de artefacto exportado. Los archivos CSV coinciden con el formato del archivo de importación CSV, excepto para:
- La columna ID de artefacto adicional, que contiene identificadores para artefactos en lugar de identificar artefactos por nombre y vía de acceso de categoría.
- Los artefactos relacionados se definen con ID de artefacto en lugar de contexto y nombre.
Este método es útil en los siguientes tipos de circunstancias:
- Desea mover todos los artefactos de gobierno de una instancia de IBM Knowledge Catalog a otra.
Consulte Importación de varios tipos de artefactos de gobernabilidad desde una instancia con un archivo ZIP.
La tabla siguiente resume las diferencias entre la importación de artefactos con archivos CSV o un archivo ZIP.
Características | archivo CSV | Archivo zip |
---|---|---|
Creación de archivos | • Exportar un tipo de artefactos existentes • Crear un archivo en un programa de hoja de cálculo • Exportar artefactos de IBM InfoSphere Information Governance Catalog y ajustar el formato |
Exportar varios tipos de artefactos desde una instancia |
Número de tipos de artefacto | Categorías o un tipo de artefacto por archivo. | Varios tipos de artefactos, con categorías y cada tipo de artefacto en un archivo CSV independiente. |
métodos de importación | • A través de la interfaz de usuario • solicitud de API |
Solicitud de API |
Flujo de trabajo | Todos los artefactos se importan como borrador y están sujetos al flujo de trabajo. Las categorías se publican inmediatamente porque no están sujetas al flujo de trabajo. | Todos los artefactos y categorías se publican inmediatamente. |
Permisos necesarios | Permisos para crear o editar categorías. Debe ser al menos un editor en la categoría a la que está importando. Para obtener detalles, consulte Permisos necesarios. | El permiso Gestionar glosario |
Artefactos de gobernabilidad que puede importar
Con ambos métodos de importación, puede importar categorías y los siguientes tipos de artefactos de gobernabilidad:
- Términos empresariales
- Clasificaciones
- Clases de datos
- Reglas de gobernabilidad
- Políticas
- Conjuntos de datos de referencia
Restricciones:
- Puede importar valores para todas las propiedades de estos tipos de artefactos de gobernabilidad, incluidas las relaciones con otros artefactos. Sin embargo, las relaciones sólo se importan cuando el artefacto relacionado existe o está definido en el mismo proceso de importación. Para añadir relaciones que el proceso de importación ha omitido, primero publique todos los artefactos de borrador importados y, a continuación, vuelva a ejecutar el proceso de importación.
- No puede utilizar CSV para mover artefactos de gobernabilidad y sus relaciones entre instancias de Cloud Pak for Data . Por ejemplo, si intenta exportar clases de datos con el método coincidente Coincidir con datos de referencia a CSV y, a continuación, importarlos a otra instancia de Cloud Pak for Data , la importación falla, porque el ID de artefacto no se incluye en las importaciones y exportaciones de CSV. En su lugar, utilice la importación ZIP.
- Al importar un conjunto de datos de referencia de un archivo CSV, los valores de datos de referencia de ese conjunto no se importan. Debe utilizar un CSV independiente para importar los valores en el conjunto de datos. De forma alternativa, puede utilizar una importación ZIP para importar tanto el conjunto de datos de referencia como sus valores de datos de referencia. Para obtener más información, consulte Importación de archivos para conjuntos de datos de referencia.
- No puede importar reglas de protección de datos o reglas de ubicación de datos.
Métodos para fusionar artefactos importados y existentes
Tanto si importa artefactos con archivos CSV o un archivo ZIP, debe elegir qué sucede cuando importa artefactos de gobernabilidad que ya existen y los valores de las propiedades son diferentes. La tabla siguiente resume los tres métodos de fusión.
Método de fusión | API | Efecto sobre los valores originales | Efecto sobre los valores importados |
---|---|---|---|
Sustituir todos los valores | merge_option=all |
Descartar todos los valores originales. | Aceptar todos los valores importados, incluso los valores vacíos. |
Sustituir por valores definidos | merge_option=specified |
Conserve los valores originales si los valores importados están vacíos. | Aceptar todos los valores importados, excepto los valores vacíos. |
Sustituir valores vacíos | merge_option=empty |
Conservar los valores originales, excepto los valores vacíos. | Aceptar sólo los valores importados que sustituyen a los valores vacíos. |
Para los artefactos nuevos, cada uno de estos métodos produce los mismos resultados.
Sustituir todos los valores
Todos los valores originales del artefacto se descartan y se sustituyen por los valores del artefacto importado. Si el valor de una propiedad para el artefacto importado está vacío, se eliminarán los valores originales para dicha propiedad.
Por ejemplo, supongamos que tiene un término empresarial publicado que se denomina release e importa un archivo CSV para modificarlo. La tabla siguiente muestra el efecto de la opción Sustituir todos los valores :
Propiedad | Valores Originales | Valores en el archivo CSV | Valores resultantes |
---|---|---|---|
Nombre | release | release | release |
Tipo de artefacto | glossary_term | glossary_term | glossary_term |
Categoría | marketing | marketing | marketing |
Descripción | término de ejemplo | término de ejemplo editado | término de ejemplo editado |
Etiquetas | beta | beta | |
Términos relacionados | marketing> > versión | marketing> > fecha | marketing> > fecha |
Clasificaciones |
|
El artefacto de borrador resultante tiene estos cambios en los valores originales:
- La descripción original se sustituye por una descripción nueva.
- El valor vacío original para las etiquetas se sustituye por un valor.
- El término relacionado original se sustituye por un nuevo término relacionado.
- El valor de clasificación original se sustituye por un valor vacío.
Al utilizar la opción de fusión all
, 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.
Al importar archivos ZIP que contienen valores de datos de referencia, siempre debe utilizar merge_option=all
en la llamada de API.
Sustituir por valores definidos
Los valores originales y vacíos del artefacto se sustituyen por los valores suministrados del artefacto importado. Si el valor de una propiedad para el artefacto importado está vacío, se conservan los valores originales para dicha propiedad.
Por ejemplo, supongamos que tiene un término empresarial publicado que se denomina release e importa un archivo CSV para modificarlo. La tabla siguiente muestra el efecto de la opción Sustituir por valores definidos :
Propiedad | Valores Originales | Valores en el archivo CSV | Valores resultantes |
---|---|---|---|
Nombre | release | release | release |
Tipo de artefacto | glossary_term | glossary_term | glossary_term |
Categoría | marketing | marketing | marketing |
Descripción | término de ejemplo | término de ejemplo editado | término de ejemplo editado |
Etiquetas | beta | beta | |
Términos relacionados | marketing> > versión | marketing> > fecha | marketing> > fecha |
Clasificaciones |
|
|
El artefacto de borrador resultante tiene estos cambios en los valores originales:
- La descripción original se sustituye por una descripción nueva.
- El valor vacío original para las etiquetas se sustituye por un valor.
- El término relacionado original se sustituye por un nuevo término relacionado.
Sustituir valores vacíos
Los valores vacíos del artefacto original se sustituyen por los valores proporcionados del artefacto importado.
Por ejemplo, supongamos que tiene un término empresarial publicado que se denomina release e importa un archivo CSV para modificarlo. La tabla siguiente muestra el efecto de la opción Sustituir valores vacíos :
Propiedad | Valores Originales | Valores en el archivo CSV | Valores resultantes |
---|---|---|---|
Nombre | release | release | release |
Tipo de artefacto | glossary_term | glossary_term | glossary_term |
Categoría | marketing | marketing | marketing |
Descripción | término de ejemplo | término de ejemplo editado | término de ejemplo |
Etiquetas | beta | beta | |
Términos relacionados | marketing> > versión | marketing> > fecha | marketing> > versión |
Clasificaciones |
|
|
El borrador de artefacto resultante tiene este cambio en los valores originales:
- El valor vacío original para las etiquetas se sustituye por un valor.
Consideraciones acerca de la seguridad
Los datos de gobierno exportados a archivos CSV se sanean frente a ataques de inyección CSV conocidos, para ser seguros para los programas de hoja de cálculo que interpretan automáticamente los datos CSV. Como resultado, cualquier valor de texto que empiece por uno de los siguientes caracteres:
- es igual a (=)
- más (+)
- menos (-)
- a las (@)
están precedidos por un carácter de comilla simple ('). Para que la funcionalidad sea coherente, los archivos CSV importados se analizan adicionalmente para eliminar automáticamente el carácter de comilla simple ('). El saneamiento también se aplica al importar y exportar artefactos de gobernabilidad a archivos ZIP, ya que contienen archivos CSV.
Para inhabilitar esta funcionalidad:
Editar el glosario de IBM Knowledge Catalog Despliegue del servicio:
oc edit deployment wkc-glossary-service
Establezca la variable de entorno
ESCAPE_FORMULAS_IN_CSV_FILES
en el valorfalse
.
Para obtener más información, consulte Inyección de CSV.
Más información
- Importación de artefactos de gobernabilidad por tipo con archivos CSV
- Formato de archivo CSV para importar artefactos de gobernabilidad
- Importación de todos los artefactos de gobernabilidad desde una instancia con un archivo ZIP
Tema principal: Gestión de artefactos de gobierno