

AWS Data Pipeline não está mais disponível para novos clientes. Os clientes existentes do AWS Data Pipeline podem continuar usando o serviço normalmente. [Saiba mais](https://aws.amazon.com/blogs/big-data/migrate-workloads-from-aws-data-pipeline/)

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á.

# Editar o pipeline
<a name="dp-manage-pipeline-modify-console"></a>

Para alterar algum aspecto de um dos pipelines, você poderá atualizar a definição do pipeline. Depois de alterar um pipeline em execução, você deverá reativar o pipeline para que as alterações entrem em vigor. Além disso, você pode reexecutar um ou mais componentes do pipeline.

**Topics**
+ [Limitações](#dp-edit-pipeline-limits)
+ [Editando um pipeline usando o AWS CLI](#dp-edit-pipeline-aws-cli)

## Limitações
<a name="dp-edit-pipeline-limits"></a>

Enquanto o pipeline estiver no estado `PENDING` e não estiver ativado, você não poderá fazer alterações nele. Depois de ativar um pipeline, você poderá editá-lo com as restrições a seguir. As alterações feitas por você se aplicarão a novas execuções dos objetos do pipeline depois de salvá-las e reativar o pipeline.
+ Você não pode remover um objeto
+ Você não pode alterar o período de programação de um objeto existente
+ Você não pode adicionar, excluir nem modificar campos de referência em um objeto existente
+ Você não pode fazer referência a um objeto existente em um campo de saída de um novo objeto
+ Você não pode alterar a data de início programada de um objeto (em vez disso, ative o pipeline com uma data e uma hora específicas)

## Editando um pipeline usando o AWS CLI
<a name="dp-edit-pipeline-aws-cli"></a>

Você pode editar um pipeline usando as ferramentas de linha de comando.

Primeiro, baixe uma cópia da definição atual do pipeline usando o [get-pipeline-definition](https://docs.aws.amazon.com/cli/latest/reference/datapipeline/get-pipeline-definition.html)comando. Fazendo isso, você pode ter a certeza de que está modificando a definição do pipeline mais recente. O exemplo a seguir usa a definição do pipeline para a saída padrão (stdout).

```
aws datapipeline get-pipeline-definition --pipeline-id {{df-00627471SOVYZEXAMPLE}}
```

Salve a definição do pipeline em um arquivo e a edite conforme necessário. Atualize sua definição de pipeline usando o [put-pipeline-definition](https://docs.aws.amazon.com/cli/latest/reference/datapipeline/put-pipeline-definition.html)comando. O exemplo a seguir faz upload do arquivo de definição de pipeline atualizado.

```
aws datapipeline put-pipeline-definition --pipeline-id {{df-00627471SOVYZEXAMPLE}} --pipeline-definition {{file://MyEmrPipelineDefinition.json}}
```

Você pode recuperar novamente a definição do pipeline usando o comando `get-pipeline-definition` para garantir que a atualização tenha sido bem-sucedida. Para ativar o pipeline, use o seguinte comando [activate-pipeline](https://docs.aws.amazon.com/cli/latest/reference/datapipeline/activate-pipeline.html):

```
aws datapipeline activate-pipeline --pipeline-id {{df-00627471SOVYZEXAMPLE}}
```

Se preferir, você poderá ativar o pipeline em uma data e uma hora específicas usando a opção `--start-timestamp` da seguinte forma:

```
aws datapipeline activate-pipeline --pipeline-id {{df-00627471SOVYZEXAMPLE}} --start-timestamp {{YYYY}}-{{MM}}-{{DD}}T{{HH}}:{{MM}}:{{SS}}Z
```

Para reexecutar um ou mais componentes do pipeline, use o comando [set-status](https://docs.aws.amazon.com/cli/latest/reference/datapipeline/set-status.html).