Skip to main content

クラウド ストレージ コネクション ファイルの作成 (Create Clould Storage Connection File) (データ管理ツール)

サマリー

ArcGIS がサポートするクラウド ストレージ コネクション ファイルを作成します。 このツールを使用すると、既存のラスター ジオプロセシング ツールは、クラウド ラスター フォーマット (CRF) データセットをクラウド ストレージ バケットに書き込んだり、入力としてクラウド ストレージに格納されたラスター データ (CRF に限定されない) を読み取ったりすることができます。 このツールは、マッピング用の Apache Parquet ファイルにアクセスするために使用するクラウド ストレージのコネクション ファイルも作成します。

使用法

  • You must provide the necessary information to make a cloud storage connection—このツールを使用するには、アクセス キー ID、シークレット アクセス キー文字列、バケット名など。 プロバイダー オプション パラメーターを使用して、別の認証方法を使用することもできます。

    クラウド ストアの接続の詳細

  • ツールは、ArcGIS クラウド ストレージ フォーマットでバイナリー クラウド ストレージのコネクション ファイル (.acs) を出力します。

  • クラウド ストレージの場所に格納されたラスター データセットまたは Parquet ファイルにアクセスする場合、c:/temp/amazons3.acs/someraster などのファイル パスを使用して参照できます。 データセットまたはファイルがバケット内のフォルダーに格納されている場合、c:/temp/amazons3.acs/foldername/someraster など、フォルダー名がパスに含まれる必要があります。

  • このツールは、Amazon Simple Storage Service (S3) バケット、Microsoft Azure Blob Storage コンテナー、Microsoft Azure Data Lake Storage Gen2、Alibaba Cloud Object Storage Service (OSS) バケット、Google Cloud Storage Service (GCS) バケット、WebHDFS、MinIO、および Ozone Object Storage Service バケットへの接続をサポートしています。 Parquet ファイルにアクセスする場合、Amazon S3、Azure Blob Storage コンテナー、Microsoft Azure Data Lake Storage Gen2、および GCS バケットがサポートされています。

  • ツールは、実行時に提供される資格情報を検証します。 コネクションが作成できない場合、このツールは警告を返します。

  • Azure Active Directory を使用した OAuth 2.0 認証は、Azure および Azure Data Lake Storage Gen2 のユーザー向け対話型ログインでサポートされています。 Google Cloud Storage Service 向けの OAuth 2.0 認証もサポートされています。 構成については、ArcGIS から認証プロバイダーに接続をご参照ください。 設定が完了し、ユーザーがサインインすると、Google、Azure、および Azure Data Lake Storage Gen2 の認証パラメーターが有効になります。 リージョンとエンドポイントは構成から取得されます。

  • Azure 仮想マシン上の Entra ID を使用したユーザー割り当てマネージド ID のサポートは、Azure および Azure Data Lake Storage Gen2 で使用できます。

  • ロールベースのアクセス制御 (RBAC) は、Amazon、Azure、Google クラウド プロバイダーで使用できます。 Amazon Elastic Compute Cloud (EC2)、Azure 仮想マシン、または Google Compute Engine を使用する際、すべての認証パラメーターを空のままにしておくと、ArcGIS Pro は IAM ロールまたは Azure RBAC を使用して Blob ストレージにアクセスできるようになります。 Amazon では、IMDSv1 と IMDSv2 がサポートされています。

  • Microsoft Azure Data Lake Storage Gen2 では Azure と同じオプションがサポートされていますが、DFS エンドポイントを使用した完全なディレクトリー サポートとアトミック操作を提供します。 クラウド操作時のネットワーク エラーの一部は、指数的バックオフに従って再試行されます。

  • Amazon では、AWS IAM Identity Center (AWS SSO) がサポートされています。 AWS SSO を使用するには、AWS CLI をインストールし、AWS SSO を構成してサイン インします。 AWS SSO 構成に使用する SSO 開始 URL および SSO 領域は、管理者から入手してください。 AWS SSO ログインの有効期限が切れるまで、セッション トークン管理は ACS によって自動的に処理されます。 ログインの有効期限が切れたら、ACS を有効に保つために再度サイン インしてください。

    AWS SSO を使用するには、領域 (環境) および サービス エンド ポイント パラメーターの値、プロバイダー オプション パラメーターの AWS_PROFILE オプションが必須で、値が正確である必要があります。

  • Amazon では、Amazon S3 Express One Zone ディレクトリー バケットがサポートされています。 ディレクトリー バケットにアクセスするには、管理者が S3 ACL (アクセス制御リスト) の権限をアカウントに付与する必要があります。 通常のバケットで使用できるすべての認証方法が、ディレクトリー バケットでもサポートされています。 ディレクトリー バケットにアクセスするための一時的なセッション トークンがある場合は、アクセス キー ID および シークレット アクセス キー パラメーター、プロバイダー オプション パラメーターの AWS_S3SESSION_TOKEN オプションを使用します。

  • パフォーマンスの注意事項と詳細については、GDAL 仮想ファイル システムに関するドキュメントをご参照ください。

    注意:

    Esri は、ArcGIS と互換性のあるストレージ プロバイダーが ArcGIS と互換性があることをテスト、証明、または保証するものではなく、Esri テクニカル サポートで互換性の問題のトラブルシューティングを行うことはできません。

パラメーター

ラベル 説明 データ タイプ

コネクション ファイルの場所

コネクション ファイル (.acs) の作成先となるフォルダー パス。

Folder

コネクション ファイル名

クラウド ストレージのコネクション ファイルの名前。

String

サービス プロバイダー

使用するクラウド ストレージ サービス プロバイダーを指定します。

  • Azure—サービス プロバイダーは Microsoft Azure になり、Parquet ファイルへのアクセスがサポートされます。

  • Amazon—サービス プロバイダーは Amazon S3 になり、Parquet ファイルへのアクセスがサポートされます。

  • Google—サービス プロバイダーは Google Cloud Storage になり、Parquet ファイルへのアクセスがサポートされます。

  • Alibaba—サービス プロバイダーは Alibaba Cloud Storage になります。

  • WebHDFS—WebHDFS をサービス プロバイダーに指定します。

  • MinIO—MinIO をサービス プロバイダーに指定します。

  • Azure Data Lake—サービス プロバイダーは Microsoft Azure Data Lake Storage になり、Parquet ファイルへのアクセスがサポートされます。

  • Ozone—Ozone をサービス プロバイダーに指定します。

  • Web—一般的な HTTP URL へのアクセスに使用されるサービス プロバイダー。

String

バケット (コンテナー) 名

ラスター データセットまたは Parquet ファイルを格納するクラウド ストレージ コンテナーの名前。 この場所をラスター ジオプロセシング ツールの出力用に使用すると、出力ラスター データセットが格納されるコンテナーになります。 多くのクラウド プロバイダーがこのコンテナーをバケットと呼んでいます。

String

アクセス キー ID (アカウント名)

(オプション)

特定のクラウド ストレージ タイプのアクセス キー ID 文字列。 Azure のように、アカウント名でもあります。

String

シークレット アクセス キー (アカウント キー)

(オプション)

クラウド ストレージへの接続の認証に使用されるシークレット アクセス キー文字列。

Encrypted String

リージョン (環境)

(オプション)

クラウド ストレージのリージョン文字列。 指定した場合、値はクラウド ストレージの選択によって定義された形式を使用する必要があります。 デフォルトは、選択したクラウド プロバイダーのデフォルト アカウントです。

String

サービス エンド ポイント

(オプション)

oss-us-west-1.aliyuncs.com など、クラウド ストレージのサービス エンドポイント (URI)。 パラメーターを指定しない場合は、選択されたクラウド ストレージ タイプのデフォルトのエンドポイントが使用されます。 必要に応じて、CNAME リダイレクト エンドポイントが使用されます。

String

プロバイダー オプション

(オプション)

特定タイプのクラウド サービスに関する構成オプションを指定します。 サービスによってはオプションがないものもあります。 オプションをオンにしたいときだけ、このパラメーターを設定する必要があります。 以下に説明するように、Parquet ファイルにアクセスするためのクラウド ストレージ コネクション ファイルを作成する際は、オプションのサブセットのみがサポートされます。

  • Azure および Microsoft Azure Data Lake Storage

    • AZURE_STORAGE_SAS_TOKEN—共有アクセス署名を指定します。 その値が URL エンコードされており、先頭に '?' または '&' 文字が含まれていないことを確認してください。 このオプションを使用する場合は、シークレット アクセス キー (アカウント キー) パラメーターを空にする必要があります。 このオプションは、Parquet ファイルにアクセスするためにサポートされています。

    • AZURE_NO_SIGN_REQUEST—認証アクセスを必要としないバケット (コンテナー) に匿名で接続します。 このオプションを使用する場合は、シークレット アクセス キー (アカウント キー) パラメーターを空にする必要があります。 デフォルト値は False です。 このオプションは、Parquet ファイルにアクセスするためにサポートされています。

    • AZURE_STORAGE_CONNECTION_STRING—Azure Storage 接続文字列を指定します。 この文字列には、アカウント名、キー、およびエンドポイントが埋め込まれています。 このオプションを使用する場合、アクセス キー ID (アカウント名) および シークレット アクセス キー (アカウント キー) パラメーターは空でなければなりません。 このオプションは、Parquet ファイルにアクセスするためにサポートされています。

    • CPL_AZURE_USE_HTTPS—HTTP リクエストを使用する場合は False に設定します。 サーバーによっては、HTTPS リクエストのみをサポートするように構成されている場合があります。 デフォルト値は True です。

    • AZURE_IMDS_OBJECT_ID—Azure VM に複数のユーザー割り当てマネージド ID が設定されている場合、Azure インスタンス メタデータ サービス (IMDS) を使用して認証されたマネージド ID のオブジェクト ID を指定します。

    • AZURE_IMDS_CLIENT_ID—Azure VM に複数のユーザー割り当てマネージド ID が設定されている場合、Azure IMDS を使用して認証されたマネージド ID のクライアント ID を指定します。

    • AZURE_IMDS_MSI_RES_ID—Azure VM に複数のユーザー割り当てマネージド ID が設定されている場合、Azure IMDS を使用して認証されたマネージド ID のリソース ID を指定します。

  • Amazon および MinIO

    • AWS_NO_SIGN_REQUEST—認証アクセスを必要としないバケット (コンテナー) に匿名で接続します。 デフォルト値は False です。 このオプションは、Parquet ファイルにアクセスするためにサポートされています。

    • AWS_SESSION_TOKEN—一時的な認証情報を指定します。 このオプションは、Parquet ファイルにアクセスするためにサポートされています。

    • AWS_S3SESSION_TOKEN—ディレクトリー バケットにアクセスするための 一時的な認証情報を指定します。

    • AWS_PROFILE—AWS 認証情報プロファイルは、アクセス キーまたは ID が見つからない場合に自動的に使用されます。 このオプションを使用して、使用するプロファイルを指定できます。 このオプションは、Parquet ファイルにアクセスするためにサポートされています。

    • AWS_REQUEST_PAYER—このオプションをリクエスタに設定することで、リクエスタ支払いバケットにアクセスできます。

    • AWS_Virtual_Hosting—パススタイルのリクエストだけをサポートしている Amazon S3 または S3 対応クラウド プロバイダーを使用している場合、このオプションを True に設定します。 サポートされている場合は、仮想ホスティングを使用することをおすすめします。 デフォルト値は True です。

    • CPL_VSIS3_USE_BASE_RMDIR_RECURSIVE—一部の古い S3 対応の実装では、一括削除操作はサポートされていません。 このようなプロバイダーでは、このオプションを False に設定します。 デフォルト値は True です。

    • AWS_HTTPS—HTTP リクエストを使用する場合は False に設定します。 サーバーによっては、HTTPS リクエストのみをサポートするように構成されている場合があります。 デフォルト値は True です。

  • Google

    • GS_NO_SIGN_REQUEST—認証アクセスを必要としないバケット (コンテナー) に匿名で接続します。 デフォルト値は True です。 このオプションは、Parquet ファイルにアクセスするためにサポートされています。

    • GS_USER_PROJECT—OAuth2 キーと課金用のプロジェクトを設定することで、リクエスタ支払いバケットにアクセスできます。 このオプションを使用してプロジェクトを設定し、他のオプションを使用して OAuth2 キーを設定し、HMAC キーをシークレット アクセス キーまたは ID に設定しないようにします。

    • GS_OAUTH2_REFRESH_TOKEN—OAuth2 リフレッシュ アクセス トークンを指定します。 GS_OAUTH2_CLIENT_ID と GS_OAUTH2_CLIENT_SECRET を使用して OAuth2 クライアントの認証情報を設定します。

    • GOOGLE_APPLICATION_CREDENTIALS—プライベート キーとクライアントの電子メール アドレスを含む .json ファイルを使用して、サービス アカウント OAuth2 認証情報を指定します。 このオプションは、Parquet ファイルにアクセスするためにサポートされています。

    • GS_OAUTH2_PRIVATE_KEY—プライベートキー文字列を使用して、サービス アカウント OAuth2 認証情報を指定します。 GS_AUTH2_CLIENT_EMAIL が設定される必要があります。

    • GS_OAUTH2_PRIVATE_KEY_FILE—ファイルからプライベート キーを使用して、Service Account OAuth2 認証情報を指定します。 GS_AUTH2_CLIENT_EMAIL が設定される必要があります。

    • GS_AUTH2_CLIENT_EMAIL—クライアントの電子メール アドレスを使用して、サービス アカウント OAuth2 認証情報を指定します。

    • GS_AUTH2_SCOPE—サービス アカウント OAuth2 スコープを指定します。 有効な値は https://www.googleapis.com/auth/devstorage.read_write (デフォルト) と https://www.googleapis.com/auth/devstorage.read_only です。

    • GDAL_HTTP_HEADER_FILE—外部ファイルに格納されたベアラー認証情報を指定します。

  • Alibaba

    • OSS_Virtual_Hosting—パススタイルのリクエストだけをサポートしている Alibaba または S3 対応クラウド プロバイダーを使用している場合、このオプションを True に設定します。 サポートされている場合は、仮想ホスティングを使用することをおすすめします。 デフォルト値は True です。

    • OSS_HTTPS—HTTP リクエストを使用する場合は False に設定します。 サーバーによっては、HTTPS リクエストのみをサポートするように構成されている場合があります。 デフォルト値は True です。

  • WebHDFS

    • WEBHDFS_REPLICATION (整数) - ファイルの作成時にレプリケーション値が使用されます。

    • WEBHDFS_PERMISSION (10 進数) - ファイルの作成時にパーミッション マスクが使用されます。

複数の認証パラメーターを指定した場合、優先順位は次のとおりです。

  • Azure—AZURE_STORAGE_CONNECTION_STRING、アカウント名またはキー、AZURE_STORAGE_SAS_TOKEN、AZURE_NO_SIGN_REQUEST、または RBAC。

  • Amazon—AWS_NO_SIGN_REQUEST、アクセス ID またはキー、AWS_SESSION_TOKEN、AWS Credential Profile、IAM Role。

  • Google—GS_NO_SIGN_REQUEST、アクセス ID またはキー、GDAL_HTTP_HEADER_FILE、(GS_OAUTH2_REFRESH_TOKEN or GS_OAUTH2_CLIENT_ID and GS_OAUTH2_CLIENT_SECRET)、GOOGLE_APPLICATION_CREDENTIALS、(GS_OAUTH2_PRIVATE_KEY or GS_OAUTH2_CLIENT_EMAIL)、(GS_OAUTH2_PRIVATE_KEY_FILE or GS_OAUTH2_CLIENT_EMAIL)、または IAM Role。

  • Ozone

    • AWS_PROFILE—AWS 認証情報プロファイルは、アクセス キーまたは ID が見つからない場合に自動的に使用されます。 このオプションを使用して、使用するプロファイルを指定できます。

    • AWS_Virtual_Hosting—パススタイルのリクエストだけをサポートしている Amazon S3 または S3 対応クラウド プロバイダーを使用している場合、このオプションを True に設定します。 サポートされている場合は、仮想ホスティングを使用することをおすすめします。 デフォルト値は True です。

    • AWS_HTTPS—HTTP リクエストを使用する場合は False に設定します。 サーバーによっては、HTTPS リクエストのみをサポートするように構成されている場合があります。 デフォルト値は True です。

    • CPL_VSIS3_USE_BASE_RMDIR_RECURSIVE—一部の古い S3 対応の実装では、一括削除操作はサポートされていません。 このようなプロバイダーでは、このオプションを False に設定します。 デフォルト値は True です。

    • x-amz-storage-class—単一のコンテナーである Ozone に書き込むために REDUCED_REDUNDANCY を指定します。Ozone には単一のデータ ノードが存在するためです。

  • Web

    Web オプションを使用する場合、ACS を使用して認証済みの HTTP/HTTPS エンドポイントにアクセスできます。 認証パラメーターは、プロバイダー オプションとして渡され、エンドポイントへのアクセスに使用されます。

    • GDAL_HTTP_USERPWD—接続に使用する HTTP ユーザーとパスワード。 [user name]:[password] の形式で指定する必要があります。 認証方法は、GDAL_HTTP_AUTH で決定します。

    • GDAL_HTTP_NETRC_FILE—.netrc ファイルの場所を設定します。

    • GDAL_HTTP_HEADERS—ヘッダーを key:value pairs のカンマ区切りリストとして指定します。

    • GDAL_HTTP_BEARER—接続に使用する HTTP OAuth 2.0 Bearer Access トークンを設定します。 GDAL_HTTP_AUTH=BEARER と併用する必要があります。

    • GDAL_HTTP_AUTH—[BASIC/NTLM/NEGOTIATE/ANY/ANYSAFE/BEARER] を使用する認証方法の種類を選択します。

    • GDAL_HTTP_SSLCERT—PKI 認証の SSL クライアント証明書のファイル名。

    • GDAL_HTTP_SSLKEY—PKI 認証の TLS および SSL クライアント証明書のプライベート キー ファイルのパス。

    • GDAL_HTTP_KEYPASSWD—GDAL_HTTP_SSLKEY のプライベート キーのパス フレーズ。

上記のプロバイダー オプション以外に、ARC_DEEP_CRAWL オプションも、すべてのサービス プロバイダーで使用することができます。 このオプションを True に設定すると、クラウド内で拡張子が付いていない CRF およびクラウド対応のラスター プロダクトを識別できます。 この処理には多大な操作が必要なため、カタログ参照操作と巡回操作を高速化する場合は、このオプションを False に設定することをおすすめします。 デフォルト値は False です。

カスタム トークン ベンディング サービス (Planetary Computer のデータ収集など) は、ARC_TOKEN_SERVICE_API (トークン ベンダーの URL) と ARC_TOKEN_OPTION_NAME (サービス プロバイダーのトークンのタイプ) のプロバイダー オプションを使用して認証できます。

注意:

GDAL_DISABLE_READDIR_ON_OPEN オプションは、すべてのサービス プロバイダーで使用できます。 クラウドベース ラスターの読み込みパフォーマンスを向上させるため、このオプションはデフォルトで NO に設定されています。 ラスターが 30,000 を超えるアイテムを含むフォルダーに存在する場合、このオプションを YES に設定します。

値テーブル列:

  • Name—The name of the provider configuration.

  • Value—The value of the provider configuration.

Value Table

フォルダー

(オプション)

ラスター データセットまたは Parquet ファイルが格納される バケット (コンテナー) 名 パラメーター値内のフォルダー。 この場所をラスター ジオプロセシング ツールの出力用に使用すると、出力ラスター データセットが格納されるフォルダーになります。

String

認証

(オプション)

OAuth 2.0 認証のコネクション名。

オプション ダイアログ ボックスの 認証 タブで、有効なコネクションを構成する必要があります。

String

派生した出力

ラベル 説明 データ タイプ

出力コネクション ファイル

出力のクラウド ストレージのコネクション ファイル パス。

File

環境

このツールは、ジオプロセシング環境を一切使用しません。

ライセンス情報

  • Basic: はい
  • Standard: はい
  • Advanced: はい