MaxCompute:プロジェクト接続の管理

前提条件

MaxCompute Studio をインストールしている必要があります。

ステップ 1：MaxCompute Studio プロジェクトを作成する

1. IntelliJ IDEA を起動します。メインメニューバーで、[ファイル] > [新規] > [プロジェクト] を選択します。

2. [新規プロジェクト] ダイアログボックスの左側のナビゲーションウィンドウで、[MaxCompute Studio] をクリックします。次に、[次へ] をクリックします。

   

3. [プロジェクト名] パラメーターを構成し、[完了] をクリックします。

   

   説明

   プロジェクトが開いている場合は、ダイアログボックスが表示され、新しいプロジェクトを新しいウィンドウで開くか、現在のウィンドウで開くかを尋ねられます。この場合は、[このウィンドウ] をクリックできます。

ステップ 2：MaxCompute プロジェクトに接続する

1. メインメニューバーで、[表示] > [ツールウィンドウ] > [プロジェクトエクスプローラー] を選択します。

   

2. プロジェクトエクスプローラーページの左上隅にあるプラス記号（[+]）をクリックし、[AccessId/Key からプロジェクトを追加] を選択します。

   

3. [MaxCompute プロジェクトを追加] ダイアログボックスで、[接続] タブのパラメーターを構成します。

   

   説明

   • 接続タブの左下隅にある アイコンをクリックして、オンラインドキュメントを表示します。

   • タイムアウトエラーが発生した場合は、[設定] タブをクリックし、次のパラメーターを変更します。

     • [1 つのテーブルの同期タイムアウト (秒)]：テーブル同期のタイムアウト期間。デフォルト値：5。単位：秒。

     • [1 つの関数の同期タイムアウト (秒)]：関数同期のタイムアウト期間。デフォルト値：30。単位：秒。

   • 構成ファイルを使用してパラメーターを自動的に構成します。次の表にパラメーターを示します。

     パラメーター	説明
     [プロパティファイル]	MaxCompute クライアント (odpscmd) の構成ファイル odps_config.ini が保存されているディレクトリ。詳細については、「MaxCompute クライアントのインストールと構成」をご参照ください。構成ファイルは、[アクセス ID]、[アクセスキー]、[プロジェクト名]、および [エンドポイント] パラメーターの設定を初期化するために使用されます。
     [AK アカウント]	MaxCompute プロジェクトへの接続に使用する Alibaba Cloud アカウント。[+] をクリックし、[アカウント] ページで既存のアカウントを選択できます。 説明 アカウントが存在しない場合は、[+] をクリックし、[AccessKey による Alibaba Cloud アカウント] を選択して、[アカウント] ページにアカウントを追加する必要があります。アカウントを手動で追加するか、構成ファイルを使用してアカウントを自動的に追加できます。 アカウントページのパラメーターの詳細については、「アカウントの構成項目」をご参照ください。

   • パラメーターを手動で構成します。次の表にパラメーターを示します。

     パラメーター	説明
     [アクセス ID]	MaxCompute プロジェクトへの接続に使用する AccessKey ID。
     [アクセスキー]	MaxCompute プロジェクトへの接続に使用する AccessKey シークレット。
     [プロジェクト名]	アクセスする MaxCompute プロジェクトの名前。 説明 このパラメーターは、MaxCompute プロジェクトに対応する DataWorks ワークスペースの名前ではなく、MaxCompute プロジェクトの名前を指定します。 MaxCompute プロジェクトの名前を表示したり、MaxCompute プロジェクトを作成したりするには、次の操作を実行します。MaxCompute コンソール にログオンします。上部のナビゲーションバーで、リージョンを選択します。左側のナビゲーションウィンドウで、[ワークスペース] > [プロジェクト] を選択します。
     [エンドポイント]	MaxCompute プロジェクトが存在するリージョンのエンドポイント。オンプレミス環境のマシンなど、Alibaba Cloud の内部ネットワークを使用していないマシンに MaxCompute クライアントがデプロイされている場合は、パブリックエンドポイントを使用して MaxCompute プロジェクトに接続する必要があります。

4. [OK] をクリックします。 [プロジェクトエクスプローラー] ページには、テーブル、ビュー、ユーザー定義関数（UDF）、リソースなど、MaxCompute プロジェクトに関する情報が表示されます。

ステップ 3: MaxCompute プロジェクトへの接続を変更する

1. [プロジェクトエクスプローラー] ページで、目的の MaxCompute プロジェクトを右クリックし、[プロジェクトのプロパティを変更] を選択します。

   

2. [MaxCompute プロジェクトの変更] ダイアログボックスで、MaxCompute プロジェクトの構成を変更します。

FAQ

[接続] タブでパラメーターを構成し、[OK] をクリックした後、次の一般的なエラーが報告される場合があります。

• エラーメッセージ：Test connection fail: ODPS-0420111: Project not found - '<project_name>'. または Test connection fail:ODPS-0130013:Authorization exception-Authorization Failed [4002], You don't exist in project <project_name>. Context ID:<context ID>. --->Tips: Pricipal:ALIYUN$<account_name> | RAM$[<account_name>:]<RAM user name>;

  • 考えられる原因

    • 接続しようとしている MaxCompute プロジェクトが存在しないか、MaxCompute プロジェクトの名前が無効です。

    • AccessKey ペアが使用されている Alibaba Cloud アカウントまたは RAM ユーザーが MaxCompute プロジェクトに追加されていません。

  • 解決策

    • MaxCompute コンソール にログオンします。上部のナビゲーションバーで、リージョンを選択します。左側のナビゲーションウィンドウで、[ワークスペース] > [プロジェクト] を選択します。[プロジェクト] ページで、MaxCompute プロジェクトの名前を取得します。次に、[プロジェクト名] パラメーターの値を変更します。

    • プロジェクトのオーナーが、共同データ開発のために別のユーザーを MaxCompute プロジェクトに接続させる場合、そのユーザーをプロジェクトに追加する必要があります。詳細については、「Alibaba Cloud アカウント (プロジェクトレベル) を追加する」または「RAM ユーザー (プロジェクトレベル) を追加する」をご参照ください。

• エラーメッセージ：Test connection fail: connect timed out, the possible reason is that the endpoint '<endpoint>' is wrong, please check your endpoint

  • 考えられる原因：[エンドポイント] パラメーターの値が無効です。たとえば、コンピューター上の MaxCompute Studio を使用してインターネット経由で MaxCompute プロジェクトに接続しようとしていますが、Alibaba Cloud のクラウド製品相互接続ネットワークのエンドポイントを入力しています。

  • 解決策：このパラメーターを、接続するプロジェクトのリージョンとネットワーク環境に一致するエンドポイントに設定します。エンドポイントはエンドポイントから取得できます。

• エラーメッセージ：Test connection fail: The specified project or table name is not valid or missing.

  • 考えられる原因：構成した [エンドポイント] パラメーターの値が、MaxCompute ではなく MaxCompute Tunnel にアクセスするために使用される MaxCompute Tunnel のエンドポイントです。

  • 解決策：このパラメーターを、MaxCompute Tunnel のエンドポイントではなく、接続するプロジェクトのリージョンとネットワーク環境に一致するエンドポイントに設定します。エンドポイントはエンドポイントから取得できます。