Importa metodi per le risorse di governance
È possibile importare le risorse di governance con un file. È possibile importare un tipo di artefatto di governance alla volta, oppure importare tutti gli artefatti di governance da un'altra istanza di IBM Knowledge Catalog.
- Compatibilità tra ambienti di distribuzione
- Confronto dei metodi di importazione
- Risorse di governance che è possibile importare
- Metodi per unire le risorse utente importate ed esistenti
- Considerazioni sulla sicurezza
Compatibilità tra ambienti di distribuzione
È possibile esportare e quindi importare gli artefatti di governance tra le istanze di IBM Knowledge Catalog nei seguenti ambienti di distribuzione:
- Cloud Pak for Data 3.5
- Cloud Pak for Data 4.x
- Cloud Pak for Data as a Service
I valori degli Steward non sono compatibili tra le istanze di IBM Knowledge Catalog Cloud Pak for Data as a Service e Cloud Pak for Data 3.5 o 4.x.
È possibile importare gli artefatti di governance da IBM InfoSphere Information Governance Catalog alle istanze di IBM Knowledge Catalog su Cloud Pak for Data 3.5 e 4.x. Per importare gli artefatti di governance da IBM InfoSphere Information Governance Catalog alle istanze di IBM Knowledge Catalog su Cloud Pak for Data as a Service, è necessario modificare ogni file CSV per renderlo conforme al formato dei file CSV degli artefatti di IBM Knowledge Catalog. Ad esempio, potrebbe essere necessario apportare i seguenti tipi di modifiche:
- Rimuovi colonne non supportate
- Separare diversi tipi di risorse utente in più file CSV
- Modifica colonne supportate
- Aggiungi colonne richieste
Confronto dei metodi di importazione
Scegliere il metodo di importazione appropriato per i propri obiettivi e circostanze.
- Importare un singolo tipo di risorsa utente
È possibile importare un singolo tipo di risorsa utente di governance alla volta con un file CSV.
Questo metodo è utile nei seguenti tipi di circostanze:
- Si desidera che le risorse importate siano soggette al flusso di lavoro.
- Si desidera aggiungere valori per una proprietà a un tipo di risorsa utente di governance. Esportare il tipo di risorsa utente come file CSV, modificare il file CSV e quindi importarlo. Ad esempio, è possibile utilizzare questo metodo per aggiungere un attributo personalizzato ai termini di business.
- Si desidera definire le risorse utente in un altro programma. Creare file CSV per ciascun tipo di risorsa utente. Ad esempio, è possibile utilizzare questo metodo per definire le risorse utente in un programma foglio di calcolo e quindi importarle.
Consultare Importazione di risorse utente di governance per tipo con file CSV e Formato file CSV per l'importazione delle risorse utente di governance.
- Importa più tipi di risorse utente
È possibile importare più tipi di artefatti di governance con un file ZIP creato esportando più tipi di artefatti di governance esistenti da un'istanza di IBM Knowledge Catalog. Il file ZIP contiene i file CSV per le categorie e ogni tipo di risorsa utente esportato. I file CSV corrispondono al formato del file di importazione CSV, ad eccezione di:
- La colonna ID risorsa utente aggiuntiva, che contiene gli identificativi per le risorse utente invece di identificare le risorse utente per nome e percorso della categoria.
- Le risorse utente correlate sono definite con ID risorsa utente invece che con contesto e nome.
Questo metodo è utile nei seguenti tipi di circostanze:
- Si desidera spostare tutti gli artefatti di governance da un'istanza di IBM Knowledge Catalog a un'altra.
Consultare Importazione di più tipi di risorse utente di governance da un'istanza con un file ZIP.
La seguente tabella riepiloga le differenze tra l'importazione di risorse utente con file CSV o un file ZIP.
Caratteristiche | File CSV | File ZIP |
---|---|---|
Creazione di file | Esportare un tipo di risorse utente esistenti Creare un file in un programma foglio di calcolo Esportare le risorse utente da IBM InfoSphere Information Governance Catalog e modificare il formato |
Esporta più tipi di risorse utente da un'istanza |
Numero di tipi di risorsa utente | Categorie o un tipo di risorsa utente per file. | Più tipi di risorse utente, con categorie e ogni tipo di risorsa utente in un file CSV separato. |
Metodi di importazione | Tramite la richiesta API dell'interfaccia utente |
Richiesta API |
Flusso di lavoro | Tutte le risorse utente sono importate come bozza e sono soggette al flusso di lavoro. Le categorie vengono pubblicate immediatamente perché non sono soggette al flusso di lavoro. | Tutte le risorse utente e le categorie vengono pubblicate immediatamente. |
Autorizzazioni richieste | Autorizzazioni per creare o modificare categorie. È necessario essere almeno un Editor nella categoria in cui si sta eseguendo l'importazione. Per i dettagli vedere Autorizzazioni richieste. | L'autorizzazione Gestisci glossario |
Risorse utente di governance che è possibile importare
Con entrambi i metodi di importazione, è possibile importare categorie e i seguenti tipi di risorse di governance:
- Termini di business
- Classificazioni
- Classi dati
- Regole di governance
- politiche
- Dataset di riferimento
Limitazioni:
- È possibile importare valori per tutte le proprietà di questi tipi di risorse utente di governance, incluse le relazioni con altre risorse utente. Tuttavia, le relazioni vengono importate solo quando la risorsa utente correlata esiste o è definita nello stesso processo di importazione. Per aggiungere le relazioni ignorate dal processo di importazione, pubblicare prima tutte le risorse utente bozza importate, quindi eseguire nuovamente il processo di importazione.
- Non puoi utilizzare CSV per spostare le risorse di governance e le loro relazioni tra istanze Cloud Pak for Data . Ad esempio, se si tenta di esportare le classi di dati con il metodo corrispondente Corrispondenza con i dati di riferimento in CSV e quindi importarli in un'altra istanza Cloud Pak for Data , l'importazione non riesce perché l'ID risorsa utente non è incluso nelle importazioni ed esportazioni CSV. Utilizzare invece l'importazione ZIP.
- Quando si importa un dataset di riferimento da un file CSV, i valori dei dati di riferimento da tale serie non vengono importati. È necessario utilizzare un CSV separato per importare i valori nel dataset. In alternativa, è possibile utilizzare un'importazione ZIP per importare sia il dataset di riferimento che i relativi valori dei dati di riferimento. Per ulteriori informazioni, consultare Importazione di file per dataset di riferimento.
- Non è possibile importare le regole di protezione dei dati.
Metodi per l'unione di risorse utente importate ed esistenti
Se si importano risorse utente con file CSV o un file ZIP, è necessario scegliere cosa accade quando si importano risorse utente di governance già esistenti e i valori delle proprietà sono differenti. La seguente tabella riassume i tre metodi di unione.
Metodo di unione | Services | Effetto sui valori originali | Effetto sui valori importati |
---|---|---|---|
Sostituisci tutti i valori | merge_option=all |
Eliminare tutti i valori originali. | Accetta tutti i valori importati, anche quelli vuoti. |
Sostituisci con valori definiti | merge_option=specified |
Conservare i valori originali se i valori importati sono vuoti. | Accettare tutti i valori importati, tranne quelli vuoti. |
Sostituisci valori vuoti | merge_option=empty |
Conservare i valori originali, tranne i valori vuoti. | Accetta solo valori importati che sostituiscono valori vuoti. |
Per le nuove risorse utente, ciascuno di questi metodi produce gli stessi risultati.
Sostituisci tutti i valori
Tutti i valori originali della risorsa utente vengono eliminati e sostituiti dai valori della risorsa utente importata. Se il valore di una proprietà per la risorsa utente importata è vuoto, tutti i valori originali per tale proprietà vengono rimossi.
Ad esempio, si supponga di disporre di un termine di business pubblicato denominato release e di importare un file CSV per modificarlo. La seguente tabella mostra l'effetto dell'opzione Sostituisci tutti i valori :
Proprietà | Valori originali | Valori nel file CSV | Valori risultanti |
---|---|---|---|
Nome | rilascio | rilascio | rilascio |
Tipo di risorsa utente | termine_glossario | termine_glossario | termine_glossario |
Categoria | marketing | marketing | marketing |
Descrizione | termine di esempio | termini di esempio modificati | termini di esempio modificati |
Tag | beta | beta | |
Termini correlati | marketing>> versione | marketing>> data | marketing>> data |
Classificazioni |
|
La risorsa utente di bozza risultante presenta le seguenti modifiche ai valori originali:
- La descrizione originale viene sostituita da una nuova.
- Il valore vuoto originale per le tag viene sostituito da un valore.
- Il termine correlato originale viene sostituito da un nuovo termine correlato.
- Il valore di classificazione originale viene sostituito da uno vuoto.
Quando si utilizza l'opzione di unione all
, è necessario assicurarsi che tutto il contenuto CSV sia congruente per quanto riguarda le relazioni tra le risorse utente. Ad esempio, se il file di importazione ZIP contiene sia un termine che una classe di dati collegati con una relazione, questa relazione deve essere presente in entrambe le classi di dati CSV e CSV. In caso contrario, il comportamento dell'importazione della relazione è imprevedibile, la relazione può essere importata o meno.
Quando si importano i file ZIP che contengono valori di dati di riferimento, è necessario utilizzare sempre merge_option=all
nella chiamata API.
Sostituisci con valori definiti
I valori originali e vuoti della risorsa vengono sostituiti dai valori forniti della risorsa importata. Se il valore di una proprietà per la risorsa utente importata è vuoto, vengono conservati tutti i valori originali per tale proprietà.
Ad esempio, si supponga di disporre di un termine di business pubblicato denominato release e di importare un file CSV per modificarlo. La seguente tabella mostra l'effetto dell'opzione Sostituisci con valori definiti :
Proprietà | Valori originali | Valori nel file CSV | Valori risultanti |
---|---|---|---|
Nome | rilascio | rilascio | rilascio |
Tipo di risorsa utente | termine_glossario | termine_glossario | termine_glossario |
Categoria | marketing | marketing | marketing |
Descrizione | termine di esempio | termini di esempio modificati | termini di esempio modificati |
Tag | beta | beta | |
Termini correlati | marketing>> versione | marketing>> data | marketing>> data |
Classificazioni |
|
|
La risorsa utente di bozza risultante presenta le seguenti modifiche ai valori originali:
- La descrizione originale viene sostituita da una nuova.
- Il valore vuoto originale per le tag viene sostituito da un valore.
- Il termine correlato originale viene sostituito da un nuovo termine correlato.
Sostituisci valori vuoti
I valori vuoti della risorsa utente originale vengono sostituiti dai valori forniti della risorsa utente importata.
Ad esempio, si supponga di disporre di un termine di business pubblicato denominato release e di importare un file CSV per modificarlo. La seguente tabella mostra l'effetto dell'opzione Sostituisci valori vuoti :
Proprietà | Valori originali | Valori nel file CSV | Valori risultanti |
---|---|---|---|
Nome | rilascio | rilascio | rilascio |
Tipo di risorsa utente | termine_glossario | termine_glossario | termine_glossario |
Categoria | marketing | marketing | marketing |
Descrizione | termine di esempio | termini di esempio modificati | termine di esempio |
Tag | beta | beta | |
Termini correlati | marketing>> versione | marketing>> data | marketing>> versione |
Classificazioni |
|
|
La risorsa utente bozza risultante ha questa modifica ai valori originali:
- Il valore vuoto originale per le tag viene sostituito da un valore.
Considerazioni sulla sicurezza
I dati di governance esportati in file CSV vengono ripuliti rispetto agli attacchi CSV Injection noti, per essere sicuri per quei programmi di fogli di calcolo che interpretano automaticamente dati CSV. Di conseguenza, qualsiasi valore di testo che inizia con uno dei seguenti caratteri:
- uguale a (=)
- più (+)
- meno (-)
- alle (@)
sono preceduti da un apice ('). Per rendere congruente la funzionalità, i file CSV importati vengono inoltre analizzati per rimuovere automaticamente il carattere virgolette singole ('). La ripulitura si applica anche quando si importano ed esportano le risorse utente di governance in file ZIP, poiché contengono file CSV.
Per disabilitare questa funzionalità:
Modifica dell'implementazione del servizio IBM Knowledge Catalog Glossary:
oc edit deployment wkc-glossary-service
Impostare la variabile di ambiente
ESCAPE_FORMULAS_IN_CSV_FILES
sul valorefalse
.
Per ulteriori informazioni, vedi Iniezione CSV.
Ulteriori informazioni
- Importazione di risorse di governance per tipo con file CSV
- Formato file CSV per l'importazione delle risorse di governance
- Importazione di tutte le risorse di governance da un'istanza con un file ZIP
Argomento principale: Gestione delle risorse di governance