

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# SageMaker Canvas アプリケーションデータを独自の SageMaker AI スペースに保存する
<a name="canvas-spaces-setup"></a>

インポートするデータセットやモデルアーティファクトなどの Amazon SageMaker Canvas アプリケーションデータは、*Amazon SageMaker Studio プライベートスペース*に保存されます。スペースは、ユーザープロファイルごとに 100 GB のストレージを持つアプリケーションデータのストレージボリューム、スペースのタイプ (この場合は Canvas アプリケーション)、アプリケーションのコンテナのイメージで構成されます。Canvas をセットアップして初めてアプリケーションを起動すると、SageMaker AI はユーザープロファイルを割り当て、Canvas データを保存するデフォルトのプライベートスペースを作成します。SageMaker AI は、ユーザーに代わってスペースを自動的に作成するため、スペースを確保するために追加の設定を行う必要はありません。ただし、デフォルトのスペースを使用しない場合は、自分で作成したスペースを指定できます。これは、データを分離する場合に役立ちます。次のページでは、Canvas アプリケーションデータを保存するための独自の Studio スペースを作成して設定する方法を示します。

**注記**  
カスタム Studio スペースを設定できるのは、新しい Canvas アプリケーションに対してのみです。既存の Canvas アプリケーションのスペース設定を変更することはできません。

## [開始する前に]
<a name="canvas-spaces-setup-prereqs"></a>

SageMaker Canvas アプリケーションを作成して使用するには、Amazon SageMaker AI ドメインまたはユーザープロファイルに 100 GB 以上のストレージが必要です。

SageMaker AI コンソールを使用してドメインを作成した場合には、十分なストレージがデフォルトでプロビジョンされるため、追加のアクションは必要はありません。[CreateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateDomain.html) または [ CreateUserProfile](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateUserProfile.html) API を使用してドメインまたはユーザープロファイルを作成した場合は、`MaximumEbsVolumeSizeInGb` 値を 100 GB 以上に設定してください。より大きなストレージ値を設定するには、新しいドメインまたはユーザープロファイルを作成するか、[UpdateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateDomain.html) または [UpdateUserProfile](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateUserProfile.html) API を使用して既存のドメインまたはユーザープロファイルを更新できます。

## 新しいスペースを作成する
<a name="canvas-spaces-setup-new-space"></a>

まず、Canvas アプリケーションデータを保存するように設定された新しい Studio スペースを作成します。これは、次のステップで新しい Canvas アプリケーションを作成するときに指定するスペースです。

スペースを作成するには、 AWS SDK for Python (Boto3) または を使用できます AWS CLI。

------
#### [ SDK for Python (Boto3) ]

次の例は、 メソッドを使用して AWS SDK for Python (Boto3) `create_space`、Canvas アプリケーションに使用できるスペースを作成する方法を示しています。必ず次のパラメータを指定してください。
+ `DomainId`: SageMaker AI ドメインの ID を指定します。ID を検索するには、SageMaker AI コンソール ([https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/)) に移動し、**[ドメイン]** セクションでドメインを探します。
+ `SpaceName`: 新しいスペースの名前を指定します。
+ `EbsVolumeSizeinGb`: スペースのストレージボリュームサイズを指定します (GB 単位)。最小値は `5` で、最大値は `16384` です。
+ `SharingType`: このフィールドは `Private` として指定します。詳細については、「[Amazon SageMaker Studio のスペース](studio-updated-spaces.md)」を参照してください。
+ `OwnerUserProfileName`: ユーザープロファイル名を指定します。ドメインに関連付けられているユーザープロファイル名を探すには、SageMaker AI コンソール ([https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/)) に移動し、**[ドメイン]** セクションでドメインを探します。ドメインの設定では、ユーザープロファイルを表示できます。
+ `AppType`: このフィールドは `Canvas` として指定します。

```
response = client.create_space(
    DomainId='<your-domain-id>', 
    SpaceName='<your-new-space-name>',
    SpaceSettings={
        'AppType': 'Canvas',
        'SpaceStorageSettings': {
            'EbsStorageSettings': {
                'EbsVolumeSizeInGb': <storage-volume-size>
            }
        },
    },
    OwnershipSettings={
        'OwnerUserProfileName': '<your-user-profile>'
    },
    SpaceSharingSettings={
        'SharingType': 'Private'
    }  
)
```

------
#### [ AWS CLI ]

次の例は、 メソッドを使用して AWS CLI `create-space`、Canvas アプリケーションに使用できるスペースを作成する方法を示しています。必ず次のパラメータを指定してください。
+ `domain-id`: ドメインの ID を指定します。ID を検索するには、SageMaker AI コンソール ([https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/)) に移動し、**[ドメイン]** セクションでドメインを探します。
+ `space-name`: 新しいスペースの名前を指定します。
+ `EbsVolumeSizeinGb`: スペースのストレージボリュームサイズを指定します (GB 単位)。最小値は `5` で、最大値は `16384` です。
+ `SharingType`: このフィールドは `Private` として指定します。詳細については、「[Amazon SageMaker Studio のスペース](studio-updated-spaces.md)」を参照してください。
+ `OwnerUserProfileName`: ユーザープロファイル名を指定します。ドメインに関連付けられているユーザープロファイル名を探すには、SageMaker AI コンソール ([https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/)) に移動し、**[ドメイン]** セクションでドメインを探します。ドメインの設定では、ユーザープロファイルを表示できます。
+ `AppType`: このフィールドは `Canvas` として指定します。

```
  
create-space
--domain-id <your-domain-id>
--space-name <your-new-space-name>  
--space-settings '{
        "AppType": "Canvas", 
        "SpaceStorageSettings": {
            "EbsStorageSettings": {"EbsVolumeSizeInGb": <storage-volume-size>}
        },
     }'
--ownership-settings '{"OwnerUserProfileName": "<your-user-profile>"}'
--space-sharing-settings '{"SharingType": "Private"}'
```

------

これでスペースが確保されます。次のステップでは、スペースの名前を追跡します。

## 新しい Canvas アプリケーションを作成する
<a name="canvas-spaces-setup-new-app"></a>

スペースを作成したら、そのスペースをストレージロケーションとして指定する新しい Canvas アプリケーションを作成します。

新しい Canvas アプリケーションを作成するには、 AWS SDK for Python (Boto3) または を使用できます AWS CLI。

**重要**  
Canvas アプリケーションを作成するには AWS CLI 、 AWS SDK for Python (Boto3) または を使用する必要があります。SageMaker AI コンソールを介して Canvas アプリケーションを作成する際にカスタムスペースを指定することはサポートされていません。

------
#### [ SDK for Python (Boto3) ]

次の例は、 メソッドを使用して AWS SDK for Python (Boto3) `create_app`新しい Canvas アプリケーションを作成する方法を示しています。必ず次のパラメータを指定してください。
+ `DomainId`: SageMaker AI ドメインの ID を指定します。
+ `SpaceName`: 前のステップで作成したスペースの名前を指定します。
+ `AppType`: このフィールドは `Canvas` として指定します。
+ `AppName`: アプリ名として`default`を指定します。

```
response = client.create_app(  
    DomainId='<your-domain-id>',
    SpaceName='<your-space-name>',
    AppType='Canvas', 
    AppName='default'  
)
```

------
#### [ AWS CLI ]

次の例は、 `create-app`メソッドを使用して AWS CLI 新しい Canvas アプリケーションを作成する方法を示しています。必ず次のパラメータを指定してください。
+ `DomainId`: SageMaker AI ドメインの ID を指定します。
+ `SpaceName`: 前のステップで作成したスペースの名前を指定します。
+ `AppType`: このフィールドは `Canvas` として指定します。
+ `AppName`: アプリ名として`default`を指定します。

```
create-app
--domain-id <your-domain-id>
--space-name <your-space-name>
--app-type Canvas
--app-name default
```

------

これで、アプリケーションデータのストレージロケーションとしてカスタム Studio スペースを使用する新しい Canvas アプリケーションが完成しました。

**重要**  
Canvas アプリケーションを削除 (またはログアウト) して、アプリケーションを再作成する必要がある場合は、`SpaceName` フィールドにスペースを指定して、Canvas でこのスペースを使用する必要があります。

スペースは、スペース設定で指定したユーザープロファイルにアタッチされます。Canvas アプリケーションはスペースを削除せずに削除でき、そのスペースに保存されているデータは残ります。スペースに保存されているデータは、ユーザープロファイルを削除するか、スペースを直接削除した場合にのみ削除されます。