

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Habilitar pontos de verificação
<a name="model-checkpoints-enable"></a>

Depois de ativar o ponto de verificação, a SageMaker IA salva os pontos de verificação no Amazon S3 e sincroniza seu trabalho de treinamento com o bucket do ponto de verificação S3. Você pode usar buckets de uso geral do S3 ou de diretório do S3 para o ponto de verificação do bucket do S3. 

![\[Diagrama de arquitetura dos pontos de verificação de escrita durante o treinamento.\]](http://docs.aws.amazon.com/pt_br/sagemaker/latest/dg/images/checkpoints_write.png)


O exemplo a seguir mostra como configurar caminhos de ponto de verificação ao criar um estimador de SageMaker IA. Para habilitar pontos de verificação, adicione os parâmetros `checkpoint_s3_uri` e `checkpoint_local_path` ao seu estimador. 

O modelo de exemplo a seguir mostra como criar um estimador genérico de SageMaker IA e ativar o checkpoint. Você pode usar esse modelo para os algoritmos compatíveis especificando o parâmetro `image_uri`. Para encontrar uma imagem do Docker URIs para algoritmos com ponto de verificação suportado pela SageMaker IA, consulte [Caminhos de registro do Docker e](https://docs.aws.amazon.com/sagemaker/latest/dg-ecr-paths/sagemaker-algo-docker-registry-paths) código de exemplo. Você também pode `Estimator` substituir `estimator` e por classes principais de estimadores e classes de estimadores de outras estruturas de SageMaker IA, como, e. `[TensorFlow](https://sagemaker.readthedocs.io/en/stable/frameworks/tensorflow/using_tf.html#create-an-estimator)` `[PyTorch](https://sagemaker.readthedocs.io/en/stable/frameworks/pytorch/using_pytorch.html#create-an-estimator)` `[MXNet](https://sagemaker.readthedocs.io/en/stable/frameworks/mxnet/using_mxnet.html#create-an-estimator)` `[HuggingFace](https://huggingface.co/docs/sagemaker/train#create-a-hugging-face-estimator)` `[XGBoost](https://sagemaker.readthedocs.io/en/stable/frameworks/xgboost/using_xgboost.html#create-an-estimator)`

```
import sagemaker
from sagemaker.estimator import Estimator

bucket=sagemaker.Session().default_bucket()
base_job_name="sagemaker-checkpoint-test"
checkpoint_in_bucket="checkpoints"

# The S3 URI to store the checkpoints
checkpoint_s3_bucket="s3://{}/{}/{}".format(bucket, base_job_name, checkpoint_in_bucket)

# The local path where the model will save its checkpoints in the training container
checkpoint_local_path="/opt/ml/checkpoints"

estimator = Estimator(
    ...
    image_uri="<ecr_path>/<algorithm-name>:<tag>" # Specify to use built-in algorithms
    output_path=bucket,
    base_job_name=base_job_name,
    
    # Parameters required to enable checkpointing
    checkpoint_s3_uri=checkpoint_s3_bucket,
    checkpoint_local_path=checkpoint_local_path
)
```

Os dois parâmetros a seguir especificam caminhos para pontos de verificação:
+ `checkpoint_local_path`: especifique o caminho local em que o modelo salva os pontos de verificação periodicamente em um contêiner de treinamento. O caminho padrão é definido como `'/opt/ml/checkpoints'`. Se você estiver usando outros frameworks ou trazendo seu próprio contêiner de treinamento, certifique-se de que a configuração do ponto de verificação do seu script de treinamento especifique o caminho para `'/opt/ml/checkpoints'`.
**nota**  
Recomendamos especificar os caminhos locais `'/opt/ml/checkpoints'` para que sejam consistentes com as configurações padrão do ponto de verificação de SageMaker IA. Se você preferir especificar seu próprio caminho local, certifique-se de combinar o caminho de salvamento do ponto de verificação em seu script de treinamento e o `checkpoint_local_path` parâmetro dos estimadores de SageMaker IA.
+ `checkpoint_s3_uri`: URI para um bucket do S3 em que os pontos de verificação são armazenados em tempo real. Você pode especificar um bucket de uso geral do S3 ou de diretório do S3 para armazenar os pontos de verificação. Para mais informações sobre os buckets do diretório do S3, consulte [Buckets de diretório](https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html) no *Guia do usuário do Amazon Simple Storage Service*. 

Para encontrar uma lista completa dos parâmetros do estimador de SageMaker IA, consulte a API [Estimator na](https://sagemaker.readthedocs.io/en/stable/api/training/estimators.html#sagemaker.estimator.Estimator) documentação do SDK do Amazon *[Python SageMaker ](https://sagemaker.readthedocs.io/en/stable)*.