0 / 0
Torna alla versione inglese della documentazione

Migrazione delle connessioni in DataStage

Ultimo aggiornamento: 12 mar 2025
Migrazione delle connessioni in DataStage

Completare le seguenti attività dopo la migrazione di lavori che contengono connessioni.

Aggiorna informazioni di connessione

La seguente tabella fornisce una panoramica delle azioni richieste dopo la migrazione dei lavori che contengono connessioni.
Tabella 1. Connessioni e azioni
Scenario Azioni
Le informazioni di connessione o le credenziali sono direttamente integrate all'interno del lavoro.
  • Il servizio di migrazione crea una connessione con le credenziali. È quindi possibile creare un flusso DataStage® , compilare questo flusso, creare un job DataStage e il job è pronto per essere eseguito dopo la migrazione.
  • Con le connessioni di flusso, quando si migra un lavoro dal tradizionale DataStage, se le proprietà incorporate nel lavoro sono diverse dalle proprietà dell'oggetto connessione dati, le proprietà della connessione incorporate nel lavoro tradizionale DataStage verranno aggiunte alla definizione del lavoro.
La connessione è parametrizzata.
  • Se non ci sono credenziali sul sistema di origine: per ogni tipo univoco di database con un riferimento parametro a cui si fa riferimento nel file ISX di origine, DataStage crea una nuova connessione con i parametri. Le proprietà vengono migrate così come sono.

    Compatibilità con funzionalità non presenti nel tradizionale DataStage:

    Sebbene sia possibile compilare ed eseguire il job, queste funzioni aggiuntive non funzioneranno: connessione di test, browser asset, dati di anteprima, importazione di un asset di dati connesso. Inoltre, non sarai in grado di utilizzare la connessione con altri servizi o strumenti del progetto come notebook, Data Refineryo Watson Machine Learning. Se si desidera utilizzare le funzioni aggiuntive o utilizzare la connessione in altri strumenti, modificare la connessione del progetto e modificare i parametri sui valori effettivi.

Le proprietà non hanno mappature uno-a-uno tra i tradizionali DataStage e DataStage in IBM Cloud Pak® for Data.
  • Parametri generati automaticamente da un flusso migrato:

    Alcune proprietà non hanno associazioni uno a uno. Queste proprietà vengono aggiunte alle serie di parametri generate automaticamente.

    Per indirizzare questi parametri, completare la seguente procedura:
    1. Dopo la migrazione, aprire ogni serie di parametri, fornire i valori predefiniti, quindi compilare.
    2. Risolvere eventuali problemi verificatisi durante la compilazione, quindi eseguire il lavoro creato durante la migrazione per il flusso DataStage migrato corrispondente.
  • Se la funzione di connessione al flusso è abilitata, DataStage crea un lavoro che contiene una connessione al flusso con i set di parametri. La maggior parte delle proprietà di connessione parametrizzate nel job DataStage tradizionale verranno parametrizzate anche nel flusso importato.

    Per abilitare le connessioni di flusso, consultare Abilita connessioni di flusso.

Specificare le informazioni sul nome host e sul numero di porta

Nei lavori nella versione tradizionale di DataStage, le informazioni sulla connessione dei dati possono essere specificate sotto forma di riferimento a un parametro.

Quando si importa uno di questi lavori nella versione moderna di DataStage, le informazioni di connessione non vengono riconosciute e il processo di importazione produce degli avvisi. Per indirizzare le avvertenze, specificare manualmente le informazioni nelle impostazioni del lavoro DataStage . Quindi, ricompilare il job.

La seguente tabella mostra le connessioni che potrebbero avere questo problema, i valori predefiniti dei parametri e i campi in DataStage tradizionali da cui derivano le informazioni sul parametro.

Nota: alcuni nomi di connessione tradizionali si associano a più nomi di connessione moderni e altri a più nomi di connessione tradizionali.

port è parametrizzato per tutte le connessioni.

Tabella 2. Connessioni e parametri
Nome connessione in DataStage Nome connessione in DataStage moderno Campo da cui deriva il valore originale in DataStage tradizionale Parametro che riceve il parametro di riferimento Valore predefinito Note
Sybase Enterprise SAP ASE Server ospite porta = 5000  
OC Sybase  SAP ASE Server ospite porta = 5000  
Db2® IBM Db2 for DataStage Istanza advanced.host advanced.port = 50000  
Db2 Enterprise IBM Db2 for DataStage Server advanced.host advanced.port = 50000  
Oracle Oracle Database for DataStage Server nome_servizio_oracle oracle_db_port = 1522  
Oracle Enterprise Oracle Database for DataStage Server nome_servizio_oracle oracle_db_port = 1522  
Hive Apache Hive Server ospite
  • porta = 10000
  • database = predefinito
 
Netezza® Enterprise IBM Netezza Performance Server for DataStage Database database
  • nomehost = < nomehost>
  • porta = 5480
 
Azienda FTP FTP URI ospite
  • modalità connessione = SSH
  • porta = 22
Anche la proprietà file_name verrà impostata su un valore predefinito nello stage del flusso associato. Il valore predefinito sarà <file_name>.

Oltre ad aggiornare manualmente le proprietà di connessione e il valore del parametro, è necessario modificare anche questa proprietà di utilizzo all'interno dello stage, quindi compilare il job.

La modalità di connessione predefinita è limitata a SSH.

Connettore Azure Storage Archiviazione file Microsoft Azure accountName, accountKey N/D https;AccountName=accountName;
AccountKey=accountKey
Se accountName o accountKey sono riferimenti di parametri, la stringa di connessione viene sostituita con un riferimento di parametro per tale campo.

Aggiorna impostazioni del lavoro per le proprietà mancanti

Quando si importano determinati job dalla versione tradizionale di DataStage nella versione moderna, alcune proprietà non vengono specificate nel job originale e potrebbe essere necessario specificarli manualmente. DataStage parametrizza automaticamente alcune proprietà. Ad esempio, host è parametrizzato in #ConnParamSet_[connection type].host#. Per impostazione predefinita, le serie di parametri vengono create per le connessioni importate a meno che la connessione non utilizzi una serie di parametri esistente, nel qual caso le propriet ... parametrizzate vengono aggiunte alla serie.

Oracle, ODBCe JDBC: un caso speciale per la creazione di serie di parametri si applica a Oracle, Db2, ODBCe JDBC. Quando questi dettagli di connessione vengono parametrizzati, le serie di parametri vengono generate con un tag identificativo univoco aggiunto al nome, nel seguente formato: ConnParamSet_[connection_type].[unique identifier tag]. Viene generata una serie di parametri univoci per ogni tag identificativo univoco. Ad esempio, quando due connessioni Oracle vengono migrate e ciascuna ha un valore Host diverso, verranno generate due serie di parametri, ConnParamSet_Oracle.host1 e ConnParamSet_Oracle.host2. Se entrambe le connessioni hanno lo stesso valore Host, condivideranno la serie di parametri ConnParamSet_Oracle.host. Le seguenti proprietà forniscono la tag identificativo univoco per le connessioni corrispondenti:

  • Db2: database
  • Oracle : host
  • ODBC: tipo di origine dati
  • JDBC: fornitore

ODBC: Un caso particolare per la denominazione dei parametri è rappresentato da ODBCConnectorPx e PxODBC, che potrebbero inserire dsn_type nel nome in modo simile a ConnParamSet_[connectorName]_[dsn_type].hostname. Un modello differente si applica a JDBC, che assume il formato ConnParamSet_JDBC.[vendor]_[property]. Se la parte della stringa protocol è leggibile, verrà riportata, altrimenti verrà tagliata dalla stringa e assumerà il formato ConnParamSet_JDBC.[property]. Questo caso si applica se dsn_type o protocollo sono disponibili. Questo scenario si applica anche a ODBC.

È anche possibile impostare l'indicatore --create-connection-paramsets su false nel comando cpdctl dsjob migrate per parametrizzare i dettagli di connessione come parametri del lavoro invece che come asset della serie di parametri. Ad esempio, host è parametrizzato in #ConnProp_[connection type]_host#. Questa opzione consente di impostare i valori dei parametri per ogni singolo lavoro. Per ulteriori informazioni sul comando CLI, vedi Strumenti della riga di comandoDataStage.

Dopo la migrazione, la maggior parte delle connessioni condividono un parametro impostato con tutte le connessioni dello stesso tipo nel flusso migrato. Ad esempio, tutte le connessioni Teradata in un flusso migrato utilizzeranno la serie di parametri ConnParamSet_Teradata.

Le seguenti proprietà hanno valori predefiniti quando sono parametrizzate, sia nel formato del parametro del job ConnProp_[connection type]_[property] che nel formato della serie di parametri ConnParamSet_[connection type].[property] :
Apache Cassandra
local_datacenter parametrizzato a #ConnParamSet_Cassandra.local_datacenter# avrà un valore predefinito di "datacenter1"
Apache Hive
Il database parametrizzato a #ConnParamSet_Hive.database# avrà un valore predefinito di "default"
DRS come Oracle
nome_servizio parametrizzato a #ConnParamSet_Oracle.nome_servizio# avrà un valore predefinito di "orcl"
CLIInformix®
Il database parametrizzato a #ConnParamSet_Informix.database# avrà un valore predefinito di "default"
Informix Azienda
Il database parametrizzato a #ConnParamSet_Informix.database# avrà un valore predefinito di "default"
Informix Carica
Il database parametrizzato a #ConnParamSet_Informix.database# avrà un valore predefinito di "default"
Informix Carico XPS
Il database parametrizzato a #ConnParamSet_Informix.database# avrà un valore predefinito di "default"
Oracle
nome_servizio parametrizzato a #ConnParamSet_Oracle.nome_servizio# avrà un valore predefinito di "orcl"
Oracle Enterprise
nome_servizio parametrizzato a #ConnParamSet_Oracle.nome_servizio# avrà un valore predefinito di "orcl"

Se la proprietà mancante è port, il processo di importazione genera avvertenze. Per indirizzare le avvertenze, specificare manualmente le informazioni nelle impostazioni del lavoro DataStage . Quindi, ricompilare il job.

La seguente tabella mostra le connessioni che potrebbero avere proprietà mancanti, le proprietà che non possono essere richiamate, il valore predefinito che verrà fornito e il campo da cui deriva il valore originale in DataStagetradizionale.

Nota: alcuni nomi di connessione tradizionali si associano a più nomi di connessione moderni e altri a più nomi di connessione tradizionali.
Tabella 3. Connessioni e proprietà
Nome connessione in DataStage Nome connessione in DataStage moderno Proprietà mancanti che ricevono automaticamente un parametro predefinito Proprietà mancanti a cui viene automaticamente assegnato un valore predefinito Note
Connettore ODBC ODBC
  • nome host
  • database
  • porta = 0
  • dsn_type = DB2
 
Connettore ODBC Enterprise ODBC Enterprise
  • nome host
  • database
  • porta = 0
  • dsn_type = DB2
Se dsn_type non è presente nell'elenco dei valori consentiti, il valore predefinito è DB2.
Connettore DRS ODBC, Oracle, IBM Db2 per DataStage (non disponibile nella versione moderna di DataStage) advanced.hostname advanced.port = 0
  • La connessione, per impostazione predefinita, verrà migrata come connettore Db2 .
  • Se si utilizza un parametro per Tipo di database, DRS viene migrato come Db2 per impostazione predefinita.
  • La proprietà RDBMS non può essere parametrizzata. Specificare uno tra ODBC, Oracleo Db2 oppure il flusso verrà importato con uno stage casuale come segnaposto e ignorerà la compilazione del flusso. È necessario eliminare manualmente lo stage casuale e aggiungere quello desiderato.
Informix Carica Informix
  • ospite
  • Password
  • nome utente
porta = 1526  
Informix Enterprise (se server remoto = true) Informix
  • ospite
  • servitore
porta = 1526  
Informix Enterprise (se server remoto = false) Informix
  • nome utente
  • Password
  • ospite
  • servitore
porta = 1526  
CLIInformix Informix
  • ospite
  • nome utente
  • Password
porta = 1526  
Informix Carico XPS Informix ospite porta = 1526  
Db2 Caricamento di massa Z (PxDB2Z) Db2 for z/OS® ospite porta = 446 Nei job migrati che contengono questa connessione, DataStage converte automaticamente altre proprietà in proprietà confrontabili in DataStagemoderno. Dopo aver migrato i lavori, assicurarsi di controllare tutte le proprietà di connessione per i valori corretti e fornirli dove è necessario.

Aggiorna informazioni sulle credenziali

Per le seguenti fasi, è necessario sostituire alcune proprietà al termine del processo di importazione:
  • Google BigQuery
  • Google Cloud Storage
  • Google Cloud Pub/Sub
Una volta terminato il processo di importazione, specificare i valori corretti per i seguenti campi:
  • client_id
  • segreto_client
  • token di accesso
  • refresh_token

Abilita connessioni di flusso

Se si dispone di un job in DataStage tradizionale che si desidera importare con una connessione, è possibile includere le proprietà di connessione nella definizione del flusso quando si esegue la migrazione del job in DataStagemoderno. Per migrare il lavoro in questo modo, è necessario utilizzare il comando CLI dsjob per eseguire la migrazione del file ISX che contiene i lavori. È necessario abilitare anche connessioni di flusso aggiungendo il parametro --enable-local-connection al comando.

Impostazione del certificato SSL

La configurazione del certificato SSL varia a seconda del connettore. Se il connettore viene migrato a un connettore di piattaforma (ad esempio Microsoft SQL Server, Greenplum, SAP ASE, Informix), è possibile fornire il certificato SSL nell'interfaccia utente della connessione dopo la migrazione.