

# Importar uma fórmula do AWS Glue DataBrew no AWS Glue Studio
<a name="glue-studio-data-preparation-import-recipe"></a>

 No AWS Glue DataBrew, uma fórmula é um conjunto de etapas de transformação de dados. As fórmulas do AWS Glue DataBrew estabelecem como transformar dados que já foram lidos, mas não descrevem onde e como ler dados nem como e onde gravá-los. Isso é configurado nos nós de origem e de destino no AWS Glue Studio. Para obter mais informações sobre fórmulas, consulte [Creating and using AWS Glue DataBrew recipes](https://docs.aws.amazon.com/databrew/latest/dg/recipes.html). 

 Para usar fórmulas do AWS Glue DataBrew no AWS Glue Studio, comece criando fórmulas no AWS Glue DataBrew. Se você já tiver fórmulas que deseja usar, pule esta etapa. 

## Permissões do IAM para o AWS Glue DataBrew
<a name="glue-studio-databrew-permissions"></a>

 Este tópico fornece informações para ajudar você a entender as ações e os recursos que você, um administrador de IAM pode usar em uma política do AWS Identity and Access Management (IAM) para a transformação Data Preparation Recipe. 

 Para obter mais informações sobre segurança no AWS Glue, consulte [Access Management](https://docs.aws.amazon.com/glue/latest/dg/security.html). 

**nota**  
 A tabela a seguir lista as permissões de que um usuário precisa para importar uma fórmula disponível do AWS Glue DataBrew. 


**Ações de transformação da fórmula de preparação de dados**  

| Ação | Descrição | 
| --- | --- | 
| databrew:ListRecipes | Concede permissão para recuperar fórmulas do AWS Glue DataBrew. | 
| databrew:ListRecipeVersions | Concede permissão para recuperar versões de fórmulas do AWS Glue DataBrew. | 
| databrew:DescribeRecipe | Concede permissão para recuperar descrição de fórmula do AWS Glue DataBrew. | 



 O perfil que você está usando para acessar essa funcionalidade deve ter uma política que permita várias ações AWS Glue DataBrew. Você pode fazer isso usando uma política `AWSGlueConsoleFullAccess` que inclua as ações necessárias ou adicionar a seguinte política em linha ao seu perfil: 

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "databrew:ListRecipes",
        "databrew:ListRecipeVersions",
        "databrew:DescribeRecipe"
      ],
      "Resource": [
        "*"
      ]
    }
  ]
}
```

------



 Para usar a transformação Data Preparation Recipe, você deve adicionar a ação `IAM:PassRole` à política de permissões. 


**Permissões adicionais necessárias**  

| Ação | Descrição | 
| --- | --- | 
| iam:PassRole | Concede permissão ao IAM para permitir que o usuário passe os perfis aprovados. | 

Sem essas permissões, ocorre o seguinte erro:

```
"errorCode": "AccessDenied"
"errorMessage": "User: arn:aws:sts::account_id:assumed-role/AWSGlueServiceRole is not 
authorized to perform: iam:PassRole on resource: arn:aws:iam::account_id:role/service-role/AWSGlueServiceRole 
because no identity-based policy allows the iam:PassRole action"
```



## Importar uma fórmula do AWS Glue DataBrew
<a name="glue-studio-databrew-import-steps"></a>

**Para importar uma fórmula do AWS Glue DataBrew e usá-la no AWS Glue Studio:**

 Caso tenha um nó de **Fórmula de preparação de dados** disponível e queira editar as etapas da fórmula diretamente noAWS Glue Studio, você precisará importar as etapas da fórmula para o seu trabalho do AWS Glue Studio. 

1.  Comece um trabalho do AWS Glue no AWS Glue Studio com uma origem de dados. 

1.  Adicione o nó **Fórmula de preparação de dados** à sua tela de trabalho.   
![\[A captura de tela mostra o modal Adicionar nó com a fórmula de preparação de dados disponível para seleção.\]](http://docs.aws.amazon.com/pt_br/glue/latest/dg/images/glue-add-node-data-preparation-recipe.png)

1.  No painel Transformar, insira um nome para a fórmula. 

1.  Escolha um ou mais nós principais selecionando os nós disponíveis na tela na lista suspensa. 

1.  Escolha **Criar fórmula**. Se a **Fórmula do autor** estiver cinza, ela não estará disponível até que os pais do nó sejam selecionados e uma sessão de visualização de dados seja concluída.   
![\[Author Data Preparation Recipe form with name field and node parents selection dropdown.\]](http://docs.aws.amazon.com/pt_br/glue/latest/dg/images/glue-author-data-preparation-recipe.png)

1.  O quadro de dados carrega e mostra informações detalhadas sobre os dados de origem. 

    Selecione o ícone de **mais ações** e escolha **Importar fórmula**.   
![\[Data preparation interface showing "Build your Recipe" with an "Add step" button.\]](http://docs.aws.amazon.com/pt_br/glue/latest/dg/images/glue-dataframe-import-recipe.png)

1.  Use o assistente de importação de fórmulas para concluir as etapas. Na etapa 1, pesquise sua fórmula, selecione-a e escolha **Avançar**.   
![\[Import recipe interface showing two recipes, with one selected for import.\]](http://docs.aws.amazon.com/pt_br/glue/latest/dg/images/import-recipe-step-1.png)

1.  Na etapa 2, escolha as opções de importação. É possível optar por acrescentar uma nova fórmula a uma já existente ou substituir uma fórmula existente. Escolha **Próximo**.   
![\[Import recipe interface showing selected recipe, version, and two imported steps.\]](http://docs.aws.amazon.com/pt_br/glue/latest/dg/images/import-recipe-step-2.png)

1.  Na etapa 3, valide as etapas da fórmula. Depois de importar sua fórmula do AWS Glue DataBrew, você poderá editá-la diretamente no AWS Glue Studio.   
![\[Recipe import interface showing two steps and a validation progress indicator.\]](http://docs.aws.amazon.com/pt_br/glue/latest/dg/images/import-recipe-step-3.png)  
![\[Import recipe interface showing validated steps for sorting and formatting data.\]](http://docs.aws.amazon.com/pt_br/glue/latest/dg/images/import-recipe-step-3-validated-2.png)

1.  Depois disso, as etapas serão importadas como parte do seu trabalho do AWS Glue. Faça as alterações de configuração necessárias na guia **Detalhes do trabalho**, como nomear seu trabalho e ajustar a capacidade alocada, conforme necessário. Escolha **Salvar** para salvar seu trabalho e a fórmula. 
**nota**  
 JOIN, UNION, GROUP\$1BY, PIVOT, UNPIVOT, TRANSPOSE não são compatíveis com a importação de fórmulas nem estarão disponíveis no modo de criação de fórmulas. 

1.  Opcionalmente, você pode concluir a criação do trabalho adicionando outros nós de transformações, conforme necessário, e adicionar nós de destino de dados. 

    Se você reordenar as etapas depois de importar uma fórmula, o AWS Glue executará a validação dessas etapas. Por exemplo, se você renomeou e depois excluiu uma coluna, e se moveu a etapa de exclusão para cima, a etapa de renomeação ficará inválida. Você pode então editar as etapas para corrigir o erro de validação. 