SageMaker Canvas アプリケーションデータを自分の SageMakerスペースに保存する

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

注記

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

開始する前に

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

SageMaker コンソールを使用してドメインを作成した場合、十分なストレージがデフォルトでプロビジョニングされるため、追加のアクションを実行する必要はありません。または を使用してドメインまたはユーザープロファイルを作成した場合はCreateDomain CreateUserProfileAPIs、 MaximumEbsVolumeSizeInGb 値を 100 GB 以上に設定してください。より大きなストレージ値を設定するには、新しいドメインまたはユーザープロファイルを作成するか、 UpdateDomain または UpdateUserProfile を使用して既存のドメインまたはユーザープロファイルを更新できますAPIs。

新しいスペースを作成する

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

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

SDK for Python (Boto3)

次の例は、 メソッドを使用して AWS SDK for Python (Boto3) create_space Canvas アプリケーションに使用できるスペースを作成する方法を示しています。これらのパラメータを必ず指定してください。

• DomainId: SageMaker ドメインの ID を指定します。ID を見つけるには、 の SageMaker コンソールに移動https://console.aws.amazon.com/sagemaker/し、ドメインセクションでドメインを見つけます。

• SpaceName: 新しいスペースの名前を指定します。

• EbsVolumeSizeinGb: スペースのストレージボリュームサイズを指定します (GB 単位）。最小値は 5で、最大値は です16384。

• SharingType: このフィールドを として指定しますPrivate。詳細については、「Amazon SageMaker Studio スペース」を参照してください。

• OwnerUserProfileName: ユーザープロファイル名を指定します。ドメインに関連付けられたユーザープロファイル名を検索するには、 の 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 コンソールに移動https://console.aws.amazon.com/sagemaker/し、ドメインセクションでドメインを見つけます。

• space-name: 新しいスペースの名前を指定します。

• EbsVolumeSizeinGb: スペースのストレージボリュームサイズを指定します (GB 単位）。最小値は 5で、最大値は です16384。

• SharingType: このフィールドを として指定しますPrivate。詳細については、「Amazon SageMaker Studio スペース」を参照してください。

• OwnerUserProfileName: ユーザープロファイル名を指定します。ドメインに関連付けられたユーザープロファイル名を見つけるには、 の 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 アプリケーションを作成する

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

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

重要

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

SDK for Python (Boto3)

次の例は、 AWS SDK for Python (Boto3) create_appメソッドを使用して新しい Canvas アプリケーションを作成する方法を示しています。これらのパラメータを必ず指定してください。

• DomainId: SageMaker ドメインの ID を指定します。

• SpaceName: 前のステップで作成したスペースの名前を指定します。

• AppType: このフィールドを として指定しますCanvas。

• AppName: アプリ名defaultとして を指定します。

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

AWS CLI

次の例は、 AWS CLI create-appメソッドを使用して新しい Canvas アプリケーションを作成する方法を示しています。これらのパラメータを必ず指定してください。

• DomainId: SageMaker ドメインの 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 アプリケーションはスペースを削除せずに削除でき、スペースに保存されているデータはそのまま残ります。スペースに保存されているデータは、ユーザープロファイルを削除するか、スペースを直接削除する場合にのみ削除されます。