開始前に

以下の手順を実行して、 IBM API キーを取得したことを確認します。

1. https://cloud.ibm.com/ にアクセスします。

2. ページの上部の 「管理」 サブメニューから、 「アクセス (IAM)」 を選択します。

3. 「サービス ID」 をクリックし、 「作成」 をクリックします。

4. 「サービス ID の作成」 の詳細を指定します。

5. [アクセス] タブで、次の操作を実行します:

   a. 「アクセス権限の割り当て」 をクリックします。

   b. 「サービス」 検索フィールドに watsonx.data と入力し、クリックします。 **「次へ」**をクリックします。

   c. 「リソース」 セクションで、 「すべてのリソース」 が選択されていることを確認します。 次へ をクリックします。

   d. 「役割とアクション」 セクションで、 MetastoreAccess および 「管理者」 を選択し、 「次へ」 をクリックします。

   e. **「追加」および「割り当て」**をクリックします。

6. API キータブをクリックし、 作成をクリックします。

7. 「API キーの作成」 の詳細を指定します。 API キーには ibmlhapikey という名前を付ける必要があります。

nzcli を使用した NPSaaS インスタンスまたはリモート・クライアントと watsonx.data の統合。

1. nz ツールをダウンロードします。

   curl -o nz -k <name of the API server URL from namespace provisioning page>/v2/download/nz-linux-amd64
   

2. 環境変数をセットアップします。

   export APISERVER_URL=<name of the API server URL from namespace provisioning page>
   export NZ_USER=<admin user name>
   export NZ_PASSWORD=<admin user password>
   

3. nzcli 実行可能ファイルに対する権限を変更します。

   chmod +x nz
   

4. nz ツールを使用して HMS をセットアップします。

    ./nz setup-hms create -connection-name <your connection name> -hms-token <your API key obtained in the `Before you begin` section> -hms-user "ibmlhapikey" -url <thrift endpoint URL retrieved from watsonx.data instance>
   

ここで、

• url Thriftエンドポイントは、 watsonx.data インスタンスから取得する URL です。 詳しくは、 HMS エンドポイントの取得 を参照してください。 また、 nz setup-hms コマンドを実行するときは、 url が以下の thrift://<host>:<port> 形式であることも確認する必要があります。
• hms-user は、デフォルトでは ibmlhapikey です。
• hms-token は、「 始める前に 」セクションで取得した API キーです。

watsonx.dataに登録した後、リモート・データベースを作成できます。

1. NPSaaS Web コンソールにログインするか、 ここ から nzsql コマンド・ライン・ツールをダウンロードします。
2. watsonx.dataからデータを照会します。 詳しくは、 watsonx.dataのデータの照会 を参照してください。