# Atualizar um esquema no AWS Glue
<a name="updating_blueprints"></a>

Você pode atualizar um blueprint se tiver um script de layout revisado, um conjunto revisado de parâmetros do blueprint ou arquivos de suporte revisados. Atualizar um blueprint cria uma nova versão.

A atualização de um blueprint não afeta os fluxos de trabalho existentes criados dele.

Você pode atualizar um esquema usando o console do AWS Glue, a API do AWS Glue ou a AWS Command Line Interface (AWS CLI).

O procedimento a seguir pressupõe que o desenvolvedor do AWS Glue criou e carregou um arquivo ZIP de esquema atualizado no Amazon S3.

**Para atualizar um blueprint (console)**

1. Verifique se você tem permissões de leitura (`s3:GetObject`) no arquivo ZIP de blueprint no Amazon S3.

1. Abra o console do AWS Glue em [https://console.aws.amazon.com/glue/](https://console.aws.amazon.com/glue/).

   Faça login como um usuário que tem permissões para atualizar um blueprint. Mude para a mesma região da AWS do bucket do Amazon S3 que contém o arquivo ZIP de blueprint.

1. No painel de navegação, escolha **Blueprints** (Esquemas).

1. Na página **Blueprints** (Esquemas), selecione um esquema e, no menu **Actions** (Ações), escolha **Edit** (Editar).

1. Na página **Edit a blueprint** (Editar um blueprint), atualize **Description** (Descrição) ou **ZIP archive location (S3)** (Localização do arquivo ZIP [S3]) do blueprint. Certifique-se de incluir o nome do arquivo no caminho.

1. Escolha **Salvar**.

   A página **Blueprints** (Esquemas) retorna e mostra que o status do esquema é `UPDATING`. Escolha o botão de atualização até que o status mude para `ACTIVE` ou `FAILED`.

1. Se o status for `FAILED`, selecione o blueprint e, no menu **Actions** (Ações), escolha **View** (Exibir).

   A página de detalhes mostra o motivo da falha. Se a mensagem do erro for “Unable to access object at location…” (Não foi possível acessar o objeto no local…) ou “Access denied on object at location…” (Acesso negado no objeto no local…), analise os seguintes requisitos:
   + O usuário ao qual você está conectado deve ter permissão de leitura no arquivo ZIP de blueprint no Amazon S3.
   + O bucket do Amazon S3 que contém o arquivo ZIP deve ter uma política de bucket que conceda permissão de leitura no objeto ao seu ID da conta da AWS. Para obter mais informações, consulte [Publicar um esquema](developing-blueprints-publishing.md).
   + O bucket do Amazon S3 que você está usando deve estar na mesma região em que você se conectou no console.
**nota**  
Se a atualização falhar, a próxima execução do blueprint usará a versão mais recente dele que tenha sido registrada ou atualizada com êxito.

**Para atualizar um blueprint (AWS CLI)**

1. Insira o comando da a seguir.

   ```
   aws glue update-blueprint --name {{<blueprint-name>}} [--description {{<description>}}] --blueprint-location s3://{{<s3-path>}}/{{<archive-filename>}}
   ```

1. Para verificar o status do blueprint, insira o comando a seguir. Repita o comando até que o status vá para `ACTIVE` ou `FAILED`.

   ```
   aws glue get-blueprint --name {{<blueprint-name>}}
   ```

   Se o status for `FAILED` e a mensagem de erro for  “Unable to access object at location…” (Não foi possível acessar o objeto no local…) ou “Access denied on object at location…” (Acesso negado no objeto no local…), analise os seguintes requisitos:
   + O usuário ao qual você está conectado deve ter permissão de leitura no arquivo ZIP de blueprint no Amazon S3.
   + O bucket do Amazon S3 que contém o arquivo ZIP deve ter uma política de bucket que conceda permissão de leitura no objeto ao seu ID da conta da AWS. Para obter mais informações, consulte [Publicar um esquema](developing-blueprints-publishing.md).
   + O bucket do Amazon S3 que você está usando deve estar na mesma região em que você se conectou no console.

**Consulte também**  
[Visão geral dos esquemas no AWS Glue](blueprints-overview.md)