0 / 0

DataStage での接続のマイグレーション

最終更新: 2025年3月12日
DataStage での接続のマイグレーション

接続を含むジョブをマイグレーションした後、以下のタスクを実行します。

接続情報の更新

次の表に、接続を含むジョブのマイグレーション後に必要なアクションの概要を示します。
表 1. 接続とアクション
シナリオ アクション
接続情報または資格情報は、ジョブの内部に直接組み込まれます。
  • マイグレーション・サービスは、資格情報を使用して接続を作成します。 その後、 DataStage® フローを作成し、このフローをコンパイルし、 DataStage ジョブを作成すると、マイグレーション後にジョブを実行する準備ができます。
  • フロー接続では、従来のDataStageからジョブを移行するとき、ジョブに組み込まれているプロパティがデータ接続オブジェクト・プロパティと異なる場合、従来のDataStageジョブに組み込まれている接続プロパティがジョブ定義に追加されます。
接続はパラメーター化されています。

  • ソース・システム上に資格情報がない場合: ソース ISX ファイルで参照されるパラメーター参照を持つ固有のタイプのデータベースごとに、 DataStage はパラメーターを使用して新しい接続を作成します。 プロパティーはそのままマイグレーションされます。

    従来のDataStageにはない機能との互換性:

    ジョブをコンパイルして実行することはできますが、テスト接続、アセット・ブラウザー、プレビュー・データ、接続済みデータ資産のインポートなどの追加機能は機能しません。 また、ノートブック、 Data Refinery、 Watson Machine Learningなどの他のプロジェクト・サービスやツールとの接続を使用することもできません。 追加機能を使用する場合、または他のツールで接続を使用する場合は、プロジェクト接続を編集し、パラメーターを実際の値に変更します。
プロパティは、従来の DataStage と IBM Cloud Pak® for Data の DataStage との間の一対一のマッピングを持ちません。

  • マイグレーションされたフローから自動生成されたパラメーター:

    一部のプロパティーには、1 対 1 のマッピングがありません。 これらのプロパティーは、自動生成されたパラメーター・セットに追加されます。

    これらのパラメーターに対処するには、以下の手順を実行します。
    1. マイグレーション後に、各パラメーター・セットを開き、デフォルト値を指定してからコンパイルします。
    2. コンパイル中に発生した問題に対処してから、マイグレーション中に作成されたジョブを、対応するマイグレーション済み DataStage フローに対して実行します。
  • フロー接続機能が有効な場合、DataStageは、パラメータ・セットを持つフロー接続を含むジョブを作成します。 従来の DataStage ジョブでパラメーター化されたほとんどの接続プロパティーも、インポートされたフローでパラメーター化されます。

    フロー接続を有効にするには、 フロー接続の有効化を参照してください。

ホスト名とポート番号の情報を指定します

従来のバージョンのDataStageのジョブでは、データ接続情報はパラメータ参照の形で指定されるかもしれません。

これらのジョブをDataStageの最新バージョンにインポートすると、接続情報が認識されず、インポート処理で警告が表示されます。 警告に対処するには、 DataStage ジョブ設定で情報を手動で指定します。 その後、ジョブを再コンパイルしてください。

以下の表に、この問題が発生している可能性がある接続、パラメーターのデフォルト値、およびパラメーター情報の派生元である従来の DataStage のフィールドを示します。

注: 一部の従来の接続名は複数の最新の接続名にマップされ、一部の最新の接続名は複数の従来の接続名にマップされます。

port は、すべての接続に対してパラメーター化されます。

表 2. 接続とパラメーター
従来の DataStage での接続名 最新の DataStage での接続名 元の値の派生元のフィールド (従来の DataStage ) パラメーター参照を受け取るパラメーター デフォルト値 注記
Sybase Enterprise SAP ASE サーバー ホスト ポート = 5000  
Sybase OC SAP ASE サーバー ホスト ポート = 5000  
Db2® IBM Db2 for DataStage インスタンス advanced.host advanced.port = 50000  
Db2 エンタープライズ IBM Db2 for DataStage サーバー advanced.host advanced.port = 50000  
Oracle Oracle Database for DataStage サーバー Oracleサービス名(oracle_service_name) oracle_db_port = 1522  
Oracle Enterprise Oracle Database for DataStage サーバー Oracleサービス名(oracle_service_name) oracle_db_port = 1522  
Hive Apache Hive サーバー ホスト
  • ポート = 10000
  • database = デフォルト
  
Netezza® エンタープライズ IBM Netezza Performance Server for DataStage データベース データベース
  • hostname = <hostname>
  • port = 5480
  
FTP Enterprise FTP URI ホスト
  • connection_mode = SSH
  • ポート = 22
 file_nameプロパティーも、関連付けられたフロー・ステージでデフォルトに設定されます。 デフォルト値は<file_name>です。

接続プロパティーとパラメーター値を手動で更新することに加えて、ステージ内でこの使用法プロパティーを変更してから、ジョブをコンパイルする必要があります。

デフォルトの接続モードはSSHに制限されています。
Azure Storage Connector Microsoft Azure File Storage accountName, accountKey N/A https;AccountName=accountName;
AccountKey=accountKey		 accountName または accountKey のいずれかがパラメーター参照である場合、接続ストリングはそのフィールドのパラメーター参照に置き換えられます。

欠落しているプロパティーのジョブ設定の更新

従来のバージョンの DataStage から最新バージョンに特定のジョブをインポートする場合、一部のプロパティーは元のジョブに指定されていないため、手動で指定しなければならない場合があります。 DataStage は、一部のプロパティーを自動的にパラメーター化します。 例えば、 host は #ConnParamSet_[connection type].host#にパラメーター化されます。 デフォルトでは、接続が既存のパラメーター・セットを使用しない限り、インポートされた接続に対してパラメーター・セットが作成されます。既存のパラメーター・セットを使用する場合は、パラメーター化されたプロパティーがそのセットに追加されます。

Oracle、 ODBC、および JDBC: パラメーター・セットを生成する特殊なケースは、 Oracle、 Db2、 ODBC、および JDBCに適用されます。 これらの接続の詳細がパラメーター化されると、パラメーター・セットが生成され、 ConnParamSet_[connection_type].[unique identifier tag]という形式の固有 ID タグが名前に付加されます。 固有 ID タグごとに固有のパラメーター・セットが生成されます。 例えば、2 つの Oracle 接続がマイグレーションされ、それぞれが異なるホスト値を持つ場合、2 つのパラメーター・セット ConnParamSet_Oracle.host1 および ConnParamSet_Oracle.host2が生成されます。 両方の接続が同じホスト値を持つ場合、それらの接続はパラメーター・セット ConnParamSet_Oracle.hostを共有します。 以下のプロパティーは、対応する接続の固有 ID タグを提供します。

  • Db2: データベース
  • Oracle : ホスト
  • ODBC: データ・ソース・タイプ
  • JDBC: ベンダー

ODBC：ODBCConnectorPxとPxODBC,は、ConnParamSet_[connectorName]_[dsn_type].hostnameのようにdsn_typeを名前に挿入することがあります。 JDBCには、 ConnParamSet_JDBC.[vendor]_[property]という形式の別のパターンが適用されます。 ストリング部分 protocol が読み取り可能な場合は持ち越され、読み取り可能でない場合はストリングから切り取られ、 ConnParamSet_JDBC.[property]の形式になります。 このケースは、dsn_type またはプロトコルが使用可能な場合に適用されます。 このシナリオは、 ODBCにも適用されます。

cpdctl dsjob migrate コマンドで --create-connection-paramsets フラグを false に設定して、パラメーター・セット資産ではなくジョブ・パラメーターとして接続の詳細をパラメーター化することもできます。 例えば、 host は #ConnProp_[connection type]_host#にパラメーター化されます。 このオプションによって, 個々のジョブごとにパラメーター値を設定することができます。 CLI コマンドについて詳しくは、 DataStage コマンド・ライン・ツールを参照してください。

マイグレーションされた後、ほとんどの接続は、マイグレーションされたフロー内の同じタイプのすべての接続とパラメーター・セットを共有します。 例えば、マイグレーションされたフロー内のすべての Teradata 接続は、パラメーター・セット ConnParamSet_Teradataを使用します。

以下のプロパティーには、 ConnProp_[connection type]_[property] ジョブ・パラメーター・フォーマットか ConnParamSet_[connection type].[property] パラメーター・セット・フォーマットかにかかわらず、パラメーター化された場合のデフォルト値があります。
Apache Cassandra
#ConnParamSet_Cassandra.local_datacenter# にパラメータ化されたlocal_datacenterのデフォルト値は"datacenter1"となる
Apache Hive
#ConnParamSet_Hive.database#にパラメータ化されたデータベースは、デフォルト値が "default "になる
Oracle としての DRS
service_name パラメータ化された #ConnParamSet_Oracle.service_name# のデフォルト値は "orcl"
Informix® CLI
#ConnParamSet_Informix.database#にパラメータ化されたデータベースは、デフォルト値が "default "になる
Informix エンタープライズ
#ConnParamSet_Informix.database#にパラメータ化されたデータベースは、デフォルト値が "default "になる
Informix ロード
#ConnParamSet_Informix.database#にパラメータ化されたデータベースは、デフォルト値が "default "になる
Informix XPS ロード
#ConnParamSet_Informix.database#にパラメータ化されたデータベースは、デフォルト値が "default "になる
Oracle
service_name パラメータ化された #ConnParamSet_Oracle.service_name# のデフォルト値は "orcl"
Oracle エンタープライズ
service_name パラメータ化された #ConnParamSet_Oracle.service_name# のデフォルト値は "orcl"

欠落しているプロパティーが port の場合、インポート・プロセスで警告が出されます。 警告に対処するには、 DataStage ジョブ設定で情報を手動で指定します。 その後、ジョブを再コンパイルしてください。

以下の表に、プロパティーが欠落している可能性がある接続、取得できないプロパティー、指定されるデフォルト値、および元の値が派生した元のフィールド (従来の DataStage) を示します。

注: 一部の従来の接続名は複数の最新の接続名にマップされ、一部の最新の接続名は複数の従来の接続名にマップされます。
表 3. 接続とプロパティー
従来の DataStage での接続名 最新の DataStage での接続名 デフォルト・パラメーターが自動的に指定されるプロパティーの欠落 デフォルト値が自動的に指定されるプロパティーの欠落 注記
ODBC Connector ODBC
  • ホスト名
  • データベース
  • ポート = 0
  • dsn_type = DB2
  
ODBCエンタープライズ・コネクター ODBC Enterprise
  • ホスト名
  • データベース
  • ポート = 0
  • dsn_type = DB2
 dsn_type が許可される値のリストにない場合、デフォルトは DB2です。
DRS Connector ODBC、 Oracle、 IBM Db2 for DataStage (最新バージョンの DataStageでは使用不可) advanced.hostname advanced.port = 0
  • デフォルトでは、接続はDb2コネクターとしてマイグレーションされます。
  • データベース・タイプのパラメーターを使用する場合、DRSは、デフォルトでDb2としてマイグレーションされます。
  • RDBMS プロパティーはパラメーター化できません。 ODBC、 Oracle、または Db2 のいずれかを指定します。そうしないと、フローはプレースホルダーとしてランダム・ステージでインポートされ、フローのコンパイルはスキップされます。 ランダム・ステージを手動で削除し、必要なステージを追加する必要があります。
Informix ロード Informix
  • ホスト
  • パスワード
  • ユーザー名
 ポート = 1526  
Informix Enterprise (リモート・サーバーが true の場合) Informix
  • ホスト
  • サーバー
 ポート = 1526  
Informix Enterprise (リモート・サーバーが false の場合) Informix
  • ユーザー名
  • パスワード
  • ホスト
  • サーバー
 ポート = 1526  
Informix CLI Informix
  • ホスト
  • ユーザー名
  • パスワード
 ポート = 1526  
Informix XPS ロード Informix ホスト ポート = 1526  
Db2 Z バルク・ロード (PxDB2Z) Db2 for z/OS® ホスト ポート = 446 この接続を含むマイグレーション済みジョブでは、 DataStage は、最新の DataStageで他のプロパティーを同等のプロパティーに自動的に変換します。 ジョブをマイグレーションした後、すべての接続プロパティーの適切な値を確認し、必要な場所に指定してください。

資格情報の更新

以下のステージでは、インポート・プロセスの終了後に一部のプロパティーを置き換える必要があります。
  • Google BigQuery
  • Google Cloud Storage
  • Google Cloud Pub/Sub
インポート・プロセスが終了したら、以下のフィールドに正しい値を指定します。
  • client_id
  • client_secret
  • access_ token
  • refresh_token

フロー接続の有効化

従来の DataStage に、接続を持つインポート対象のジョブがある場合、ジョブを最新の DataStageにマイグレーションするときに、接続プロパティーをフロー定義に含めることができます。 この方法でジョブをマイグレーションするには、 dsjob CLI コマンドを使用して、ジョブが含まれている ISX ファイルをマイグレーションする必要があります。 また、コマンドにパラメーター --enable-local-connection を追加して、フロー接続を有効にする必要もあります。

SSL証明書の設定

SSL証明書の設定はコネクタによって異なります。 コネクタがプラットフォーム・コネクタ（Microsoft SQL Server、Greenplum、SAP ASE、Informixなど）に移行される場合は、移行後の接続UIでSSL証明書を提供できます。