Puede crear conjuntos de datos de referencia fuera del catálogo en formato CSV (valor separado por comas) y luego importar o reimportar valores. También puede importar relaciones valor-correlación entre valores en varios conjuntos de datos de referencia.
Utilice uno de los métodos siguientes para importar conjuntos de datos de referencia:
Importar uno o más conjuntos de datos de referencia de un archivo ZIP exportado anteriormente utilizando una solicitud de API.
Al importar conjuntos de datos de referencia en un archivo ZIP, como se describe en Importación de todos los artefactos de gobernanza de una instancia con un archivo ZIP, debe utilizar siempre "
merge_option=all" en la llamada a la API.Importe la definición del conjunto de datos de referencia desde un archivo CSV utilizando la interfaz de usuario o una solicitud API. Se pueden importar varias definiciones de conjuntos de datos de referencia en un solo archivo. Este método no incluye valores de datos de referencia: los valores deben importarse por separado.
Importe los valores de datos de referencia de un archivo CSV para un conjunto específico utilizando la interfaz de usuario o una solicitud de API.
Importar valores de datos de referencia relacionados de un archivo CSV a un conjunto de datos de referencia existente utilizando la interfaz de usuario o una solicitud de API.
Los planes deIBM Knowledge Catalog tienen límites en cuanto al número y tamaño de los conjuntos de datos de referencia que puede crear.
Al importar o exportar un conjunto de datos de referencia en un archivo ZIP, el archivo contiene un archivo CSV que define los conjuntos de datos de referencia incluidos en dicho archivo ZIP y, en una carpeta separada, un archivo CSV por conjunto con sus valores de datos de referencia. Estos archivos CSV tienen un formato diferente.
El archivo CSV de definición del conjunto de datos de referencia contiene información sobre las propiedades de cada conjunto incluido, como su ID de artefacto, un nombre, una descripción, la categoría a la que pertenece y el tipo de conjunto de datos de referencia. Puede tener el formato siguiente:
artifact_id,Name,Artifact Type,Category,Description,Secondary Categories,Related Terms,Data Set Type
026df326-74f2-4dce-8d6b-7d2f36b09d98,Customer Non Performing Loan Status,reference_data,54b9bd8a-ddfb-4512-8d46-e26d2926981e,Distinguishes between Customers according to their number of outstanding non-performing loans.,ecf8fade-4956-4e92-9a56-308949f0cb58,a9a63e90-94df-4b00-95ec-a951189d2183,TEXT
0544a0b7-07b7-4509-8cbe-22e36caa218b,Household Life Cycle Status,reference_data,8a72919e-8c40-4a73-b190-4803deb2160d,Distinguishes between Households according to the state of existence of the Household.,ecf8fade-4956-4e92-9a56-308949f0cb58,3a6f0d98-64fc-4166-b3e4-7f2ebcbeac9f,TEXT
07cf348c-76a3-482c-9614-2b89edabbaaf,Financial Legal Status,reference_data,54b9bd8a-ddfb-4512-8d46-e26d2926981e,"Distinguishes between Individuals or Organizations according to whether they are undergoing proceedings that affect their financial standing; for example, (US) Chapter 11 status, In Liquidation, In Receivership, Bankrupt.",ecf8fade-4956-4e92-9a56-308949f0cb58,03976617-abe9-4e5a-88cf-57193b22cce1,TEXT
El archivo CSV para los valores de los datos de referencia consta como mínimo de las siguientes columnas que se definen para el conjunto de datos de referencia:
- Código
- Valor
- Descripción (opcional)
- Padre (opcional)
También puede contener otra información, como valores de datos de referencia relacionados o columnas personalizadas.
Por ejemplo, las primeras filas de un conjunto de datos de referencia para códigos NAICS son similares a las siguientes:
Code,value,description,parent
11,Agriculture, Forestry, Fishing and Hunting
111,Crop Production,Crop Produ,11
1111,Oilseed and Grain Farming,111
11111,Soybean Farming,Soybean Farming,1111
111110,Soybean Farming,Soybean Farming,1111
11112,Oilseed (except Soybean) Farming,Oilseed (except Soybean) Farming,1111
111120,Oilseed (except Soybean) Farming,Oilseed (except Soybean) Farming,1111
Obtenga más información sobre cómo formatear los archivos CSV en Formato de archivo CSV para importar artefactos de gobernabilidad. Los distintos métodos de importación se describen en Importar métodos para artefactos de gobernabilidad.
En las secciones siguientes se describe cómo importar archivos CSV para conjuntos de datos de referencia utilizando la interfaz de usuario. En la interfaz de usuario, puede ver la barra de progreso para la tarea de importación, también puede ver el resumen de la importación, con descripciones de error. Tenga en cuenta que al importar valores de datos de referencia, el número de valores guardados listados en el resumen de importación puede ser diferente del número de valores realmente importados. Esto se debe a que todos los duplicados del archivo CSV se cuentan como valores guardados, mientras que sólo uno de estos duplicados se importa finalmente (en función del método de manejo de duplicados que elija).
- Importación de ficheros con definición del conjunto de datos de referencia
- Importación de archivos con valores de datos de referencia
- Importación de columnas personalizadas
- Importación de valores relacionados
Importación de ficheros con definición del conjunto de datos de referencia
- Haga clic en Gobernanza > Datos de referencia en el menú principal.
- Haga clic en Añadir conjunto de datos de referencia y seleccione Importar desde archivo.
- Seleccione un archivo CSV que contenga la definición del conjunto de datos de referencia como se ha descrito anteriormente.
- Seleccione la opción de fusión. Tenga en cuenta que las opciones se refieren a la definición del conjunto de datos de referencia, no a sus valores. Los valores deben importarse en un paso separado.
- Pulse Siguiente
Como resultado, se crea una nueva definición del conjunto de datos de referencia. Una vez creado, puede añadirle valores manualmente o importarlos desde otro archivo CSV, como se describe en la siguiente tarea.
Importación de archivos con valores de datos de referencia
En el conjunto de datos de referencia seleccionado, pulse Cargar archivo para seleccionar un archivo CSV desde el que importar valores:
- Las filas del archivo con códigos existentes actualizan las filas existentes.
- Se añaden las filas con códigos nuevos.
Al importar valores del archivo CSV, correlacione las columnas del archivo con cualquier columna predeterminada o personalizada. Si las columnas no existen, puede crearlas.
Importación de columnas personalizadas
De forma predeterminada, los valores de un conjunto de datos de referencia tienen las columnas siguientes: código, valor, descripción (opcional) y padre (opcional). Sin embargo, es posible que desee capturar información adicional relacionada con el código en columnas personalizadas. Por ejemplo, puede tener un conjunto de datos de referencia de códigos de país y querer capturar algunos otros atributos como primer ministro del país, idioma o nombres alternativos.
Puede añadir columnas personalizadas durante la creación de un conjunto de datos de referencia desde un archivo CSV donde se definen dichas columnas, o al importar o volver a importar valores desde un archivo CSV a un conjunto de datos de referencia existente.
Consulte el ejemplo siguiente de una parte de un archivo CSV con columnas personalizadas. Este archivo se puede utilizar para importar o reimportar valores.
code,value,description,Capital City,National Day,Official Language,Population
AFG,Afghanistan,The Islamic Republic of Afghanistan,Kabul,19/08/1919,دری,37200000
ALA,Åland Islands,Åland,Mariehamn,07/05/1920,svɛ̂nːska,28007
ALB,Albania,The Republic of Albania,Tirana,28/11/1912,Albanian,2850000
DZA,Algeria,The People's Democratic Republic of Algeria,Algiers,05/07/1962,الجزائر,42200000
ASM,American Samoa,The Territory of American Samoa,Pago Pago,14/06/1889,English,55465
Para importar columnas personalizadas en el conjunto de datos de referencia:
- Abra el conjunto de datos de referencia y pulse Cargar archivo. Proporcione el archivo CSV y pulse Siguiente.
- Correlacione las columnas del archivo con las columnas predeterminadas o existentes en el conjunto de datos de referencia. Para añadir una nueva columna personalizada, en la lista desplegable Columna de destino , seleccione + Añadir columna personalizada (Opcional).
- Proporcione el nombre de columna, la descripción, el número máximo de caracteres y especifique si desea validar los valores de columna con el código de otro conjunto de datos de referencia.
- Puede marcar la columna personalizada para que forme parte de la clave compuesta. Las columnas personalizadas que forman parte de la clave compuesta son obligatorias de forma predeterminada.
- Repita los pasos para cada columna del archivo CSV que desee correlacionar.
- Cuando correlacione todas las columnas, revise la información, reorganice las columnas si es necesario y pulse Guardar.
Importación de valores relacionados
Puede importar relaciones entre valores en conjuntos de datos de referencia utilizando un archivo CSV. Los valores de los conjuntos de datos de referencia de origen y destino deben existir en el sistema para crear relaciones; de lo contrario, las relaciones no se importan. En primer lugar, importe ambos conjuntos de datos de referencia relacionados y, a continuación, utilice los mismos archivos CSV para importar relaciones.
Consulte el ejemplo siguiente de un archivo CSV con correlaciones de valores.
code,value,description,map_1_n_to_states,map_1_1_continents
IND,India,Asian country,"KA,AP,MP,DL,GJ",ASIA
USA,America,North American Country,"CA,FL,NY,TX",NorthAmerica
GER,Germany,European Country,,Europe
Para añadir valores relacionados importando un archivo CSV, realice los pasos siguientes:
- Abra el conjunto de datos de referencia para el que desea añadir valores relacionados.
- En el menú de tres puntos, pulse Cargar valores relacionados.
- Añada el archivo que desea cargar arrastrándolo a la ventana Importar valores relacionados o examinando el archivo. A continuación, pulse Siguiente.
- Elija la columna del archivo que tiene los valores de código que desea correlacionar con uno o más valores de código.
- Seleccione el tipo de relación (de uno a uno o de uno a muchos) que desee entre cada valor y el valor relacionado.
- Elija la columna del archivo que tiene los códigos relacionados de los valores de referencia con los que desea correlacionar y a qué conjunto de datos de referencia pertenecen los valores relacionados.
- Pulse Guardar.
Nota: Al trabajar con los archivos CSV con valores de datos de referencia definidos por una clave compuesta, asegúrese de que la relación padre entre los valores y los valores relacionados de correlación única y múltiple se representan como concatenación de los valores de columna personalizados CODE y de clave compuesta delimitados por |. El código siempre va primero, a continuación, los valores de columna de clave compuesta, por ejemplo: CODE|CC1|CC2|CC3.
Más información
Tema principal: Datos de referencia