はじめに
IBM Cloud Pak for Data as a Service（以下CP4DaaS）のNotebook上でデータ分析をする上で、分析対象のデータセットをIBM Cloud Object Storage（以下COS）のバケットに保管するケースを想定します。
分析対象のCSVファイルをバケットに保管したとします。ここで、NotebookからCSVファイルにアクセスするには、デプロイメントスペース上のデータ資産として扱います。このような場合、Notebookからデータファイルを呼び出すために、デプロイメントスペースで、COSのバケットに対して「接続（Connection）」を定義します。
デプロイメントスペースに登録された接続情報を利用するため、NotebookではCOSの接続情報を記述しなくてもデータをダウンロードできるようになるというメリットがあります。本記事では、この「接続（Connection）」の作成ステップと作成上ハマりやすい注意点を記載します。
※作成した接続を使ってデータ処理を行い、データ分析のパイプラインを実装することができます。詳細は以下の記事をご参照ください。
IBM Cloud Pak for Data as a ServiceのNotebookで機械学習のパイプラインを実装する際のデータ入出力を整理
0.前提
作業の前提として、IBM Cloud上でGUI画面から以下を実施しておいてください。
- Watson Studioでプロジェクトを作成（例：Telco_Customer_Churn）
- Watson Studioでデプロイメントスペースを作成（例：pipelines_deployment_space）
- COSの任意のバケットを作成(例：pipeline-bucket1)
- 以下のデータセットを分析対象データとして取り扱います。これを上記バケットに保存しておきます。（上の図の「0.アップロード」に対応）
ファイル名：Telco_Customer_Churn.csv
ファイル形式：csv
1.準備
##COSへの認証に使う「サービス資格情報」を作成
ポイント①COSでサービス資格情報を作成する際に「HMAC資格情報を含める」をオンにする
「サービス資格情報」の作成には、COSの管理画面から「サービス資格情報」を選択し、「新規資格情報」をクリックしますが、ここでのポイントは、「詳細オプション」を展開し、「HMAC資格情報を含める」を「オン」にすることです。
このようにして「サービス資格情報」を作成すると、作成した「サービス資格情報」をリストから選択して展開したときに「HMAC資格情報」に相当する"cos_hmac_keys"が生成されていることが確認できます。このうち"access_key_id"と"secret_access_key"が「接続（Connection）」を作成する際に必要になります。
{
"apikey": "**************************************",
"cos_hmac_keys": {
"access_key_id": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"secret_access_key": "YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY"
},
"endpoints": "https://control.cloud-object-storage.cloud.ibm.com/v2/endpoints",
"iam_apikey_description": "Auto-generated for key XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"iam_apikey_name": "サービス資格情報-1",
"iam_role_crn": "crn:v1:bluemix:public:iam::::serviceRole:Writer",
"iam_serviceid_crn": （以下省略）
2.接続の作成
デプロイメントスペースで接続を作成
ポイント②接続の追加では「Cloud Object Storage（インフラストラクチャー）」を選択する
「接続」を作成するデプロイメントスペースを開き「スペースに追加」>「資産タイプの選択」画面で「接続」をクリックします。
「接続の追加」画面で、「プロバイダ」欄の「IBM」にチェックします（下画面）。一覧に"Cloud Object Storage"が含まれるものが二つ表示されますが、「Cloud Object Storage (インフラストラクチャー)」の方を選択して、画面右下の「選択」をクリックします。
「接続の編集」画面では、「名前」と「バケット」にそれぞれ適切な値を入力します。
続いて、「ログインURL」に入れる値は、COSの「エンドポイント」から適切なロケーションを選択（例では Regional > us-south）し、「パブリック」に記載されているURLからコピペします。
資格情報にはCOSのサービス資格情報から以下の通り入力します。
「アクセス・キー」：access_key_idの値
「秘密鍵」：secret_key_idの値
おわりに
デプロイメントスペースへの接続の追加は基本的な機能ですが、意外とハマってしまうポイントがあります。本記事では、よりスムーズに接続を追加できるよう、そのポイントに注目してみました。