エンドポイント - MaxCompute - Alibaba Cloud ドキュメントセンター

このトピックでは、さまざまなリージョンとさまざまなネットワーク接続モードで使用されるエンドポイントについて説明します。このトピックでは、MaxCompute が他の Alibaba Cloud サービスと通信する際のネットワーク接続および課金ルールについても説明します。

背景情報

MaxComputeは、MaxComputeサービスとトンネルデータ転送サービスを提供します。

MaxCompute サービス：接続アドレスはエンドポイントで、選択したリージョンとネットワーク接続モードによって異なります。データのアップロードおよびダウンロードリクエストを除くすべてのリクエストを MaxCompute に送信できます。たとえば、テーブルの作成、関数の削除、コンピューティングジョブの実行などのリクエストを送信できます。
トンネルデータ転送サービス: 接続アドレスはトンネルエンドポイントで、選択したリージョンとネットワーク接続モードによって異なります。トンネルデータ転送サービスを使用すると、オンプレミスまたはクラウドデータソースにデータをアップロードしたり、データをダウンロードしたりできます。

ネットワーク接続モードの詳細については、「ネットワーク接続モード」をご参照ください。

異なるリージョンとネットワーク接続モードで使用されるMaxComputeエンドポイントとトンネルエンドポイントの詳細については、「異なるリージョンのエンドポイント (インターネット) 」、「異なるリージョンのエンドポイント (VPC) 」、「異なるリージョンのエンドポイント (クラウド製品を接続するための内部ネットワーク) 」をご参照ください。

シナリオ

以下のシナリオでは、MaxCompute エンドポイントまたは Tunnel エンドポイントを設定する必要があります。

ツールを使用した MaxCompute への接続
- MaxCompute クライアント (odpscmd) を使用して MaxCompute プロジェクトに接続する場合。この場合、odps_config.ini ファイルを設定する必要があります。 MaxCompute クライアントのインストールと設定方法の詳細については、「MaxCompute クライアントのインストールと設定」をご参照ください。
- MaxCompute Studio を使用して MaxCompute プロジェクトに接続する場合。詳細については、「プロジェクト接続の管理」をご参照ください。
- DataWorks を使用して MaxCompute データソースに接続する場合。 DataWorks で MaxCompute データソースを設定する方法の詳細については、「MaxCompute データソースの追加」をご参照ください。
コードの設定による MaxCompute プロジェクトへの接続
- SDK を使用して MaxCompute プロジェクトに接続する場合。詳細については、「SDK For Java」および「SDK for Python：SQL 文の使用例」をご参照ください。
- Java Database Connectivity (JDBC) ドライバーを使用して、MaxCompute プロジェクトに接続する場合。詳細については、「JDBC」をご参照ください。
- Tunnelデータ転送サービスでSQLTaskクラスを使用して、SQL文の実行結果をエクスポートします。詳細については、「SQLTask と Tunnel を使用したデータのエクスポート」をご参照ください。

注意事項

トンネルデータ転送サービスを使用する前に、次の点に注意してください。
- Tunnel エンドポイントが設定されていない場合、MaxCompute クライアントは MaxCompute から Tunnel エンドポイントを自動的に取得します。 MaxCompute は、MaxCompute クライアントから要求されたネットワークタイプや Tunnel エンドポイントのワークロードなどの要因に基づいて、Tunnel エンドポイントを MaxCompute クライアントに返します。 MaxCompute クライアントが要求するネットワークタイプは、インターネットと仮想プライベートクラウド (VPC) です。
  MaxCompute クライアントが MaxCompute から自動的に取得する Tunnel エンドポイントは固定されていません。 MaxCompute クライアントが存在するネットワークに対して、ネットワークホワイトリスト、ファイアウォールルール、VPC セキュリティグループルールなどのセキュリティポリシーを計画することを推奨します。事前に計画しておくことにより、MaxCompute クライアントが、取得した Tunnel エンドポイントに想定通りにアクセスできるようになります。
  説明
  MaxCompute クライアントが MaxCompute から動的に取得する Tunnel エンドポイントには、長期および短期のトンネルエンドポイントがあります。短期の Tunnel エンドポイントは、MaxCompute の可用性を高めます。 MaxCompute は、短期の Tunnel エンドポイントを自動的に作成、削除します。短期の Tunnel エンドポイントは保存しないことを推奨します。長期トンネルエンドポイントの詳細については、「異なるリージョンのエンドポイント (インターネット) 」および「異なるリージョンのエンドポイント (クラウド製品を接続するための内部ネットワーク) 」をご参照ください。
- Tunnel エンドポイントが設定されている場合、MaxCompute クライアントは、MaxCompute から Tunnel エンドポイントを取得する代わりに、設定された Tunnel エンドポイントを使用します。
- Tunnel エンドポイントに正常にアクセスできるよう、MaxCompute クライアントと同一リージョンにあり、MaxCompute クライアントと同一のネットワークタイプである Tunnel を設定する必要があります。
- トンネルデータ転送サービスの課金ルールは、選択したリージョンとネットワークタイプによって異なります。課金ルールの詳細については、「課金ルール」をご参照ください。
- 互換性の問題を避けるため、Data Integration of DataWorks など、MaxCompute との互換性を備えたデータ統合ツールまたはサービスを使用することを推奨します。
MaxComputeクラシックネットワークは、2024年11月30日 (水曜日) に廃止されます。クラウド製品を接続するための内部ネットワークに置き換えられます。ネットワーク接続の中断によるビジネスの中断を避けるために、VPCまたは内部ネットワークを確認して切り替えてください。

ネットワーク接続モード

MaxComputeサービスとトンネルデータ転送サービスには、次のネットワーク接続モードでアクセスできます。

インターネットからMaxComputeサービスにアクセスします。
トンネルデータ転送サービス。
VPCからMaxComputeサービスとトンネルデータ転送サービスにアクセスします。
クラウド製品を接続するために、内部ネットワークからMaxComputeサービスとトンネルデータ転送サービスにアクセスします。

MaxCompute を使用して OSS または Tablestore からデータを読み書きする前に、以下の点にご注意ください。

MaxCompute と Tablestore または OSS が同一のリージョンにデプロイされている場合、前述のすべての接続モードがサポートされます。パフォーマンスを向上させるために、クラウド製品を接続するためにVPCまたは内部ネットワークを使用することを推奨します。
MaxCompute と Tablestore または OSS が同一のリージョンにデプロイされていない場合は、インターネットを使用することを推奨します。クラウド製品の接続にVPCまたは内部ネットワークを使用すると、接続の問題が発生する可能性があります。

課金ルール

次の表に、MaxComputeサービスとトンネルデータ転送サービスの課金ルールを示します。

サービスタイプ

課金ルール

MaxCompute サービス

さまざまな種類のジョブを開発した場合や、外部テーブルを使用してデータソースからデータを読み書きする SQL ジョブを実行した場合、データコンピューティングに対して課金されます。課金ルールは、MaxCompute プロジェクトの作成時に選択した課金方法によって変わります。詳細については、次をご参照ください：

コンピューティング価格。

Tunnel サービス

トンネルデータ転送サービスを使用してデータをアップロードする場合は、課金されません。

トンネルデータ転送サービスを使用して、リージョン内のクラウドデータソースまたはオンプレミスデータソースからデータをダウンロードする場合、次の課金ルールが適用されます。

Elastic Compute Service (ECS) インスタンスと MaxCompute プロジェクトが同一リージョン内に存在している場合、クラシックネットワークまたは VPC を使用して無料でデータをダウンロードできます。
ECS インスタンスと MaxCompute プロジェクトが同一リージョン内に存在していない場合、または双方が同一リージョン内にあり、ECS インスタンスが MaxCompute にアクセスできない場合、インターネットを使用してリージョン間でデータをダウンロードすると課金されます。課金ルールの詳細については、「料金のダウンロード (従量課金) 」をご参照ください。
.
説明
Alibaba Cloud データセンターのリージョンによって、Tunnel サービスのデプロイモードとネットワーク接続モードが異なる場合があります。 Tunnel サービスを使用して、Tunnel サービスがデプロイされているリージョンとは別のリージョンに存在する MaxCompute プロジェクトのデータにアクセスすることはできません。

リージョン別のエンドポイント (インターネット)

説明

HTTP および HTTPS エンドポイントがサポートされています。 HTTPSはTLS v1.2を使用して安全な接続を確立します。

下表に示す Tunnel エンドポイントは、tunnel endpoint パラメーターに対してのみ設定できます。

地域	リージョン	MaxCompute の使用可否	パブリックエンドポイント	パブリック Tunnel エンドポイント
中国	中国 (杭州)	必須	https://service.cn-hangzhou.maxcompute.aliyun.com/api	https://dt.cn-hangzhou.maxcompute.aliyun.com
中国	中国 (上海)	必須	https://service.cn-shanghai.maxcompute.aliyun.com/api	https://dt.cn-shanghai.maxcompute.aliyun.com
中国	中国 (北京)	必須	https://service.cn-beijing.maxcompute.aliyun.com/api	https://dt.cn-beijing.maxcompute.aliyun.com
中国	中国 (ウランチャブ)	必須	https://service.cn-wulanchabu.maxcompute.aliyun.com/api	https://dt.cn-wulanchabu.maxcompute.aliyun.com
中国	中国 (深セン)	必須	https://service.cn-shenzhen.maxcompute.aliyun.com/api	https://dt.cn-shenzhen.maxcompute.aliyun.com
中国	中国 (香港)	必須	https://service.cn-hongkong.maxcompute.aliyun.com/api	https://dt.cn-hongkong.maxcompute.aliyun.com
アジア太平洋	シンガポール	必須	https://service.ap-southeast-1.maxcompute.aliyun.com/api	https://dt.ap-southeast-1.maxcompute.aliyun.com
アジア太平洋	オーストラリア (シドニー) (サービス終了)	必須	https://service.ap-southeast-2.maxcompute.aliyun.com/api	https://dt.ap-southeast-2.maxcompute.aliyun.com
アジア太平洋	マレーシア (クアラルンプール)	必須	https://service.ap-southeast-3.maxcompute.aliyun.com/api	https://dt.ap-southeast-3.maxcompute.aliyun.com
アジア太平洋	インドネシア (ジャカルタ)	必須	https://service.ap-southeast-5.maxcompute.aliyun.com/api	https://dt.ap-southeast-5.maxcompute.aliyun.com
アジア太平洋	日本 (東京)	必須	https://service.ap-northeast-1.maxcompute.aliyun.com/api	https://dt.ap-northeast-1.maxcompute.aliyun.com
ヨーロッパおよびアメリカ	ドイツ (フランクフルト)	必須	https://service.eu-central-1.maxcompute.aliyun.com/api	https://dt.eu-central-1.maxcompute.aliyun.com
ヨーロッパおよびアメリカ	米国 (シリコンバレー)	必須	https://service.us-west-1.maxcompute.aliyun.com/api	https://dt.us-west-1.maxcompute.aliyun.com
ヨーロッパおよびアメリカ	米国 (バージニア)	必須	https://service.us-east-1.maxcompute.aliyun.com/api	https://dt.us-east-1.maxcompute.aliyun.com
ヨーロッパおよびアメリカ	イギリス (ロンドン)	必須	https://service.eu-west-1.maxcompute.aliyun.com/api	https://dt.eu-west-1.maxcompute.aliyun.com
中東	UAE (ドバイ)	必須	https://service.me-east-1.maxcompute.aliyun.com/api	https://dt.me-east-1.maxcompute.aliyun.com
中東	サウジアラビア (リヤド - パートナーリージョン)	必須	https://service.me-central-1.maxcompute.aliyun.com/api	https://dt.me-central-1.maxcompute.aliyun.com

リージョン別のエンドポイント (VPC)

説明

HTTP および HTTPS エンドポイントがサポートされています。 HTTPSはTLS v1.2を使用して安全な接続を確立します。

下表に示す Tunnel エンドポイントは、tunnel endpoint パラメーターに対してのみ設定できます。

異なるリージョンのエンドポイント (クラウド製品を接続するための内部ネットワーク)

説明

HTTP および HTTPS エンドポイントがサポートされています。 HTTPSはTLS v1.2を使用して安全な接続を確立します。

下表に示す Tunnel エンドポイントは、tunnel endpoint パラメーターに対してのみ設定できます。