Visual Studio Code で VantageCloud Lake の Teradata Jupyter Notebook デモを実行する方法
概要
Visual Studio Code は、Windows、MacO、Linux と互換性のある人気のオープンソース コード エディタです。開発者は、アプリケーションのコーディング、デバッグ、構築、展開にこの統合開発環境 (IDE) を使用します。このクイックスタート ガイドでは、Visual Studio Code 内で VantageCloud Lake Jupyter ノートブック デモを起動します。
![vscode.png](../../_images/vantagecloud-lake/vantagecloud-lake-demos-visual-studio-code/vscode.png)
前提条件
始める前に、次の前提条件が整っていることを確認します。
-
インストールされた Docker Desktop
-
インストールされた Git
-
git repoをダウンロードする必要がある https://github.com/Teradata/lake-demos.git
-
-
インストールされた Visual Studio Code
-
Teradata ウェルカム レターの組織 URL とログイン詳細を含む Teradata VantageCloud Lake アカウント
-
ログインしたら、次の 手順 に従って VantageCloud Lake 環境を作成する
-
VantageCloud Lakeデモリポジトリのクローンを作成する
まず、GitHub リポジトリのクローンを作成し、プロジェクト ディレクトリに移動する。
git clone https://github.com/Teradata/lake-demos.git
cd lake-demos
Teradata Jupyter Exrementsを使用してJupyterlabのDockerコンテナを起動する
VantageCloud Lake デモを起動するには、 Teradata Jupyter Extensions for Docker が必要です。 これらの拡張機能は、SQL ipython カーネル、Teradata への接続を管理するユーティリティ、および Teradata データベースとの対話時の生産性を高めるデータベース オブジェクト エクスプローラを提供します。
次に、コンテナを起動し、既存の lake-demos ディレクトリにバインドします。オペレーティング システムに基づいて適切なコマンドを選択します。
Windows の場合は、PowerShell で docker コマンドを実行します。 |
docker run -e "accept_license=Y" -p 127.0.0.1:8888:8888 -v ${PWD}:/home/jovyan/JupyterLabRoot teradata/jupyterlab-extensions
docker run -e "accept_license=Y" -p 127.0.0.1:8888:8888 -v $PWD:/home/jovyan/JupyterLabRoot teradata/jupyterlab-extensions
docker run -e "accept_license=Y" -p 127.0.0.1:8888:8888 -v $PWD:/home/jovyan/JupyterLabRoot teradata/jupyterlab-extensions
結果の URL とトークンをメモします。 これらは、Visual Studio Code から接続を確立するために必要になります。
![terminal.png](../../_images/vantagecloud-lake/vantagecloud-lake-demos-visual-studio-code/terminal.png)
Visual Studio Code の構成
Visual Studio Codeで lake-demos
プロジェクトディレクトリを開く。リポジトリには次のプロジェクト ツリーが含まれている。
LAKE_DEMOS
vars.json ファイルを編集する
vars.json file ファイルを編集して、デモを実行するために必要な認証情報を含める
+
変数 |
値 |
"host" |
VantageCloud Lake 環境からの Public IP値 |
"UES_URI" |
VantageCloud Lake 環境からの Open Analytics |
"dbc" |
VantageCloud Lake 環境のマスター パスワード |
Public IPアドレスとOpen Analyticsエンドポイントを取得するには、次の 手順 に従います。
vars.json ファイルのパスワードを変更します。 サンプル vars.json では、すべてのユーザーのパスワードがデフォルトで「password」に設定されていることがわかります。これはサンプル ファイルに関するものであり、これらのパスワード フィールドをすべて強力なパスワードに変更し、必要に応じて保護する必要があります。 他のパスワード管理のベスト プラクティスに従ってください。 |
UseCases ディレクトリ内の vars.json へのパスを変更する
ユースケースディレクトリでは、すべての.ipynbファイルは、Jupyterlabから作業するときに、パス././vars.jsonを使用してJSONファイルから変数をロードする。Visual Studio Code から直接作業するには、vars.json を指すように各 .ipynb 内のコードを更新します。
これらの変更を行う最も簡単な方法は、左側の垂直 メニューの検索機能を使用することです。検索対象
'../../vars.json'
次のように置換します。
'vars.json'
![検索](../../_images/vantagecloud-lake/vantagecloud-lake-demos-visual-studio-code/search.png)
![置換](../../_images/vantagecloud-lake/vantagecloud-lake-demos-visual-studio-code/replace.png)
Jupyterカーネルを構成する
0_Demo_Environment_Setup.ipynb を開き、Visual Studio Codeの右上にあるSelect Kernelをクリックします。
Jupyter および Python 拡張機能をインストールしていない場合は、Visual Studio Code によってそれらをインストールするように求められます。これらの拡張機能は、Visual Studio Code がカーネルを検出するために必要です。これらをインストールするには、「Install/Enable suggested extensions for Python and Jupyter」を選択します。
![select.kernel.png](../../_images/vantagecloud-lake/vantagecloud-lake-demos-visual-studio-code/select.kernel.png)
必要な拡張機能をインストールすると、ドロップダウン メニューにオプションが表示されます。既存のJupyterカーネル を選択します。
![existing.kernel.png](../../_images/vantagecloud-lake/vantagecloud-lake-demos-visual-studio-code/existing.kernel.png)
実行中の Jupyter Server の URL を入力し、Enter キーを押します。
http://localhost:8888
![server.url.png](../../_images/vantagecloud-lake/vantagecloud-lake-demos-visual-studio-code/server.url.png)
ファイルを Docker コンテナにマウントするときにターミナルで見つかったトークンを入力し、Enter キーを押します。
![server.password.png](../../_images/vantagecloud-lake/vantagecloud-lake-demos-visual-studio-code/server.password.png)
サーバー表示名を変更する (URL を使用するには空白のままにします)
![server.display.name.png](../../_images/vantagecloud-lake/vantagecloud-lake-demos-visual-studio-code/server.display.name.png)
これで、すべての Teradata Vantage 拡張カーネルにアクセスできるようになりました。実行中の Jupyter サーバーから Python 3 (ipykernel) を選択します。
![python.kernel.png](../../_images/vantagecloud-lake/vantagecloud-lake-demos-visual-studio-code/python.kernel.png)
デモを実行する
0_Demo_Environment_Setup.ipynb 内のすべてのセルを実行して、環境をセットアップします。続いて 1_Demo_Setup_Base_Data.ipynb を実行して、デモに必要な基本データをロードします。 デモ ノートブックの詳細については、GGitHubの Teradata Lake demos ページを参照してください。
![demoenvsetup.png](../../_images/vantagecloud-lake/vantagecloud-lake-demos-visual-studio-code/demoenvsetup.png)