Skip to main content

プライベートデータストレージとしてのGCS

このガイドに従って、所有しているGoogle Cloud Storage (GCS)のインスタンスでAlteryx Data Storage (ADS)を置き換えるようにAlteryx One Platformワークスペースを設定します。

注記

今後、組織が個々のワークスペースに独自の認証セキュリティポリシーを適用する場合、ワークスペースごとにシングルサインオンを有効化できるようになります。現在Googleサービスアカウントは、Google Cloud StorageをワークスペースモードのAlteryxプライベートデータストレージとしてプロビジョニングします。ワークスペースモードでは、すべてのユーザーがAlteryx Oneワークスペースで作成、管理、使用するデータアセットにアクセスできます。ユーザーは、既定のバケットで使用するすべてのデータアセットの既定のアップロードパスと出力パスを変更できます。これにより、ワークスペース上のすべてのユーザーがGCPストレージにアクセスし、他の互換性のある接続に資格情報パススルーを実行できます。

制限事項

接続

  • Amazon Redshiftに接続することはできません。

  • プライベートデータストレージとしてGCSでプロビジョニングされたワークスペースは、Snowflake接続をサポートしていません。

  • Google Cloud Platform (GCP)の場合、Alteryx Oneでは、ワークスペースごとにGCPプロジェクトを1つのみ作成でき、同じBig Query接続(同じプロジェクトとサービスアカウント)にプッシュダウンされます。

エンジンの可用性

  • プライベートデータストレージとしてGCSでプロビジョニングされたワークスペースでは、EMR Sparkをエンジンとしてサポートしておらず、また再サンプリング機能も使用できません。

  • Alteryx Engineは、1時間を超えるジョブランタイムをサポートしていません。

プラットフォーム

  • 一度GCSをプライベートデータストレージとして設定すると、プライベートデータストレージオプション(GCSからS3など)を切り替えることはできません。

  • プライベートデータストレージとしてGCSでプロビジョニングされたワークスペースは、Machine Learningをサポートしていません。

必要条件

  • プロフェッショナルプランまたはエンタープライズAlteryx Oneプランのユーザーである。

  • Alteryx Oneでワークスペース管理者ロールが割り当てられている。

  • ターゲットのGCPプロジェクトへの管理アクセス権を所有している。

  • GCPにGCSバケットが作成されている。

Alteryx OneでのGoogle Cloud Storageセットアップガイド

GCSをプライベートデータストレージとして設定するには、まず使用するGCS認証方法を選択する必要があります。それから、ワークスペースのプライベートデータストレージとしてGCSを有効にします。

GCS認証の設定

Alteryx OneとGCSの場所の間で安全な接続を確立します。プライベートデータストレージのGCS認証には、次の2つのオプションがあります。

  • クラウド認証: クラウド認証は、Google IAMを活用してGoogleストレージへのアクセスに必要な、オンデマンドでスコープが設定されたユーザー資格情報を取得するのに使用します。

  • サービスアカウントキー: サービスアカウントキーは、Google APIを使用してアプリケーション、スクリプト、サービスを認証します。Alteryx Oneはサービスアカウントを使用して、Googleサービスアカウントを使用してワークスペースレベルの資格情報を取得します。

クラウド認証

ステップ1: シングルサインオン(SSO)を設定する

ワークスペースのSSOを設定するには、 Google Cloud Platform SSO Setup Guide (OIDC)を参照してください。

ステップ2: 内部GCPアプリケーションの設定
  1. GCPコンソールの[APIとサービス]に移動します。

  2. [OAuth同意画面]に移動します。

  3. [内部]を選択し、[作成]を選択します。

  4. [名前]フィールドに、アプリの名前を入力します。たとえば、ワークスペースの名前などを使用します。

  5. [認証済みドメイン]で[ドメインの追加]を選択し、「alteryxcloud.com」と入力します。

  6. [保存して次へ]を選択します。

  7. 次のスコープを追加します。

    openid

    https://www.googleapis.com/auth/userinfo.email

    https://www.googleapis.com/auth/userinfo.profile

    https://www.googleapis.com/auth/devstorage.read_write

    https://www.googleapis.com/auth/bigquery

  8. 登録 を選択します。

  9. [認証情報]を選択します。

  10. [認証情報を作成]を選択し、[OAuthクライアントID]を選択します。

  11. [アプリケーションの種類]ドロップダウンから[ウェブアプリケーション]を選択します。

  12. [名前]フィールドに、アプリの名前を入力します。たとえば、ワークスペースの名前などを使用します。

  13. [承認済みのリダイレクトURL]で[URIを追加]ボタンを選択し、本番環境とテスト用のコールバックURLを入力します。以下のテンプレートに従って入力します。

    1. 本番環境: https://{platformEnvironment}/workspace/${workspaceName}/sso/googleCallback

    2. テスト: https://{platformEnvironment}/workspace/test/${workspaceName}/sso/googleCallback

    3. 例:

      https://us1.alteryxcloud.com/workspace/YOUR-WORKSPACE-NAME/sso/googleCallback
      https://us1.alteryxcloud.com/workspace/test/YOUR-WORKSPACE-NAME/sso/googleCallback

    注記

    これらの変更が有効になるまでに数分かかる場合があります。

  14. [保存]を選択します。

  15. クライアントIDクライアントシークレットをメモしてコピーします。これらは後からステップ3で使用します。

ステップ3: Alteryx Oneでクラウド認証を設定する
  1. Alteryx Oneワークスペースに戻ります。

  2. [プロファイル]メニュー > [ワークスペース管理者] > [プライベートデータ処理] > [クラウド認証]に移動し、[Google Cloud Platform]を選択します。

  3. GCPコンソールで認証情報を作成した後にステップ2でコピーしたGCPクライアントIDを入力します。

  4. GCPコンソールで認証情報を作成した後にステップ2でコピーしたGCPクライアントシークレットを入力します。

  5. [保存]を選択します。

  6. Alteryx Oneから一度サインアウトして再度サインインしてから続行するように表示されます。

サービスアカウントキー

  1. [Google Cloudコンソール]に移動し、Googleアカウントでサインインします。

  2. 既存のプロジェクトがある場合は、サービスアカウントキーを作成するプロジェクトを選択します。プロジェクトがない場合は、その場でプロジェクトを作成します。

  3. 左側のペインで、[IAMと管理]を選択し、[サービスアカウント]を選択します。

  4. [サービスアカウントを作成]を選択します。

  5. 以下のサービスアカウントの詳細を入力します。

    1. サービスアカウントの名前を入力します。

    2. [オプション]説明を入力します。たとえば、Alteryx Oneワークスペースの名前などを使用します。

    3. サービスアカウントのロールを選択します。たとえば、[プロジェクト] > [編集者]など、必要に応じて特定のAPIロールなどを選択します。Alteryx Oneには、次の権限が必要です。

      storage.buckets.get

      storage.buckets.list

      storage.objects.create

      storage.objects.delete

      storage.objects.get

      storage.objects.list

    4. [続行]を選択します。

  6. [キー]セクションで、[キーを作成]を選択し、[JSON]キータイプを選択します。

  7. [JSON]キータイプを選択し、[作成]を選択します。プライベートキーが自動的に生成され、お使いのコンピューターにダウンロードされます。これは後からステップ2で使用します。

    注意

    サービスアカウントへのアクセスに使用するため、JSONキーファイルは安全に保管してください。

GCSをプライベートデータストレージとして設定する

  1. Alteryx Oneワークスペースにサインインします。

  2. [プロファイル]メニュー > [ワークスペース管理者] > [プライベートデータ処理] > [ストレージ]に移動し、[Google Cloud Storage]を選択します。

  3. サービスアカウントキーを作成した場合は、[サービスアカウントキー]から、前のステップで作成したJSONキー全体をコピーして貼り付けます。クラウド認証を設定している場合は、この手順をスキップします。

  4. [既定のバケット]に、GCSバケット名を入力します。

  5. [オプション]プロジェクトIDを入力します。これにより、[サービスアカウントキー]のプロジェクトIDが上書きされます。

  6. [保存]を選択し、プライベートデータストレージとしてGCSを使用するAlteryx Oneワークスペースをプロビジョニングします。

注記

GCSがベースストレージとして設定された後、ユーザーが初めてワークスペースにサインインする際に、Alteryx Oneで自動的に既定のパスが作成されます。

Configure GCS for Signed URL Transfers

Complete this section only if your Alteryx One workspace uses GCS signed URLs, also called presigned URLs, for uploads or downloads.

Signed URLs let files transfer directly between a user's browser and Google Cloud Storage. To support signed URL transfers, configure the required IAM permissions and Cross-Origin Resource Sharing (CORS) settings.

Configure IAM Permissions for Signed URLs

The service account used to generate a signed URL must have permission to perform the operation that the URL allows.

Depending on the required access, you can assign these predefined Google Cloud roles or create a custom role with equivalent permissions:

  • Storage Object Creator (roles/storage.objectCreator) for upload-only access.

  • Storage Object Viewer (roles/storage.objectViewer) for download-only access.

  • Storage Object Admin (roles/storage.objectAdmin) for upload, download, overwrite, and delete access.

  • A role that includes storage.buckets.get, such as Storage Bucket Viewer (roles/storage.bucketViewer), for bucket validation.

The applicable permissions include:

  • storage.objects.create

  • storage.objects.get

  • storage.objects.delete

  • storage.buckets.get

These signed URL permissions supplement the permissions already required to use GCS as Private Data Storage.

注記

If your configuration uses service account impersonation or the IAM Credentials API to generate signed URLs, grant the identity that generates the URLs the Service Account Token Creator role (roles/iam.serviceAccountTokenCreator) on the signing service account.

This role provides the iam.serviceAccounts.signBlob permission.

This additional role isn't required when Alteryx One signs URLs with the private key in the Service Account Key JSON file.

Configure CORS for Signed URL Transfers

Signed URL transfers originate from the user's browser. Configure Cross-Origin Resource Sharing (CORS) on the Default Bucket to allow requests from the Alteryx One environment.

Create a JSON file named cors-config.json with this configuration:

[
  {
    "origin": [
      "https://{platformEnvironment}"
    ],
    "method": [
      "GET",
      "PUT",
      "POST",
      "HEAD",
      "DELETE"
    ],
    "responseHeader": [
      "Content-Type",
      "Content-Length",
      "Content-Range",
      "x-goog-resumable",
      "Location",
      "Range",
      "x-goog-generation",
      "x-goog-metageneration",
      "ETag"
    ],
    "maxAgeSeconds": 3600
  }
]

Replace {platformEnvironment} with the origin of your Alteryx One environment. For example:

https://us1.alteryxcloud.com

Enter only the origin. Don’t include a workspace name, workspace path, or trailing slash.

Apply the CORS configuration to the Default Bucket with one of these commands.

  • Using gcloud:

    gcloud storage buckets update gs://{defaultBucket} --cors-file=cors-config.json
  • Using gsutil:

    gsutil cors set cors-config.json gs://{defaultBucket}

Replace {defaultBucket} with the name of the GCS bucket configured as the Default Bucket in Alteryx One.

注記

Without the required CORS configuration, browser-based uploads and downloads that use signed URLs might fail with a CORS error.

アップロードディレクトリと出力ディレクトリの場所の変更

ワークスペースの設定で、プロビジョニングされた既定のバケット内の目的の出力先とアップロード場所に更新できます。場所の設定を変更するには、次の手順を実行します。

  1. Alteryx Oneワークスペースにサインインします。

  2. [プロファイル]メニュー> [設定] > [ストレージ]の順に移動します。

  3. 出力ディレクトリまたはアップロードディレクトリの横にある[編集]を選択します。既定のバケット内に新しいディレクトリを作成することもできます。

    注記

    既定の場合、アップロードディレクトリは「gs://${defaultBucket}/${workspaceId}/${personId}/uploads」、出力ディレクトリは「gs://${defaultBucket}/${workspaceId}/${personId}/queryResults」です。

Alteryx OneでGoogle Cloud Storageのデータセットを参照する

GCSをプライベートデータストレージとして有効にすると、ユーザーは管理者がプロビジョニングした既定のバケットからデータセットを参照してインポートできます。データを参照するには、次の手順を実行します。

  1. Alteryx Oneワークスペースにサインインします。

  2. [データ]ページに移動します。

  3. [データをインポート]を選択します。左側のペインに、[データをインポート]のオプションとして[Google Cloud Storage]が表示されます。

  4. [Google Cloud Storage]を選択してデータにアクセスします。

VPC Service Controls for Private Data Storage

When configuring Private Data Storage with a GCS bucket with VPC Service Controls enabled, add the Alteryx data plane Google Cloud project to your VPC Service Controls service perimeter. Without this configuration, Alteryx services may be unable to access the storage bucket.

Alteryx Data Plane GCP Projects

Add the appropriate Alteryx data plane project number for your deployment region to the VPC Service Controls perimeter.

Region

GCP Region

Control Plane Project

GCP Project Number

us1

us-west1

c-us-w1-p00002

774973207721

eu1

europe-west3

c-eu-w3-p00003

180689404527

au1

australia-southeast1

c-au-se1-p00004

530857852645

Add Alteryx Project to VPC Service Controls Perimeter

  1. Go to the Google Cloud Console and sign in with your Google account.

  2. Go to Security > VPC Service Controls.

  3. Select the service perimeter that protects your GCS bucket and select Edit Perimeter.

  4. Under Resources, select Add Projects.

  5. Add the Alteryx data plane project number for your deployment region and select Save.