Migrazione delle connessioni in DataStage
Completare le seguenti attività dopo la migrazione di lavori che contengono connessioni.
- Aggiorna informazioni di connessione
- Specifica informazioni su nome host e numero porta
- Aggiorna le impostazioni del lavoro per le proprietà mancanti
- Aggiornamento delle informazioni sulle credenziali
- Abilita connessioni flusso
Aggiorna informazioni di connessione
Scenario | Azioni |
---|---|
Le informazioni di connessione o le credenziali sono direttamente integrate all'interno del lavoro. |
|
La connessione è parametrizzata. |
|
Le proprietà non hanno mappature uno-a-uno tra i tradizionali DataStage e DataStage in IBM Cloud Pak® for Data. |
|
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.
port
è parametrizzato per tutte le connessioni.
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 |
|
|
Netezza® Enterprise | IBM Netezza Performance Server for DataStage | Database | database |
|
|
Azienda FTP | FTP | URI | ospite |
|
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.
- 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.
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 |
|
|
|
Connettore ODBC Enterprise | ODBC Enterprise |
|
|
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 |
|
Informix Carica | Informix |
|
porta = 1526 | |
Informix Enterprise (se server remoto = true) | Informix |
|
porta = 1526 | |
Informix Enterprise (se server remoto = false) | Informix |
|
porta = 1526 | |
CLIInformix | Informix |
|
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
- Google BigQuery
- Google Cloud Storage
- Google Cloud Pub/Sub
- 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.