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

# Exemplos de comandos programáticos para cadernos do EMR
<a name="emr-managed-notebooks-headless"></a>

## Visão geral do
<a name="emr-managed-notebooks-headless-overview"></a>

Você pode executar notebooks EMR com execução a APIs partir de um script ou da linha de comando. Quando você inicia, interrompe, lista e descreve as execuções do notebook EMR fora do AWS console, você pode controlar programaticamente um notebook EMR. É possível transferir valores de parâmetros diferentes para um caderno com uma célula de caderno parametrizada. Isto elimina a necessidade de criar uma cópia do caderno para cada novo conjunto de valores de parâmetros. Para obter mais informações, consulte [Amazon EMR API actions](https://docs.aws.amazon.com/emr/latest/APIReference/API_Operations.html).

Você pode agendar ou agrupar execuções de notebooks EMR com eventos da Amazon e. CloudWatch AWS Lambda Para obter mais informações, consulte Como [usar AWS Lambda com a Amazon CloudWatch Events](https://docs.aws.amazon.com/lambda/latest/dg/services-cloudwatchevents.html).

**nota**  
Os cadernos do EMR estão disponíveis como Workspaces do EMR Studio no console. O botão **Criar Workspace** no console permite criar cadernos. Para acessar ou criar Workspaces, os usuários dos Cadernos do EMR precisam de permissões adicionais de perfil do IAM. Para obter mais informações, consulte [Amazon EMR Notebooks are Amazon EMR Studio Workspaces in the console](https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-managed-notebooks-migration.html) e [console do Amazon EMR](https://docs.aws.amazon.com/emr/latest/ManagementGuide/whats-new-in-console.html).

## Permissões de perfil para a execução programática
<a name="emr-managed-notebooks-headless-permissions"></a>

Para usar a execução programática com os Cadernos do EMR, você deve configurar as permissões de usuário com as seguintes políticas:

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

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Sid": "AllowExecutionActions",
      "Effect": "Allow",
      "Action": [
        "elasticmapreduce:StartNotebookExecution",
        "elasticmapreduce:DescribeNotebookExecution",
        "elasticmapreduce:ListNotebookExecutions"
      ],
      "Resource": [
        "*"
      ]
    },
    {
      "Sid": "AllowPassingServiceRole",
      "Effect": "Allow",
      "Action": [
        "iam:PassRole"
      ],
      "Resource": [
        "arn:aws:iam::123456789012:role/EMR_Notebooks_DefaultRole"
      ]
    }
  ]
}
```

------

Ao executar Cadernos do EMR programaticamente em um cluster de Cadernos do EMR, você deve adicionar estas permissões adicionais:

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

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Sid": "AllowRetrievingManagedEndpointCredentials",
      "Effect": "Allow",
      "Action": [
        "emr-containers:GetManagedEndpointSessionCredentials"
      ],
      "Resource": [
        "arn:aws:emr-containers:*:123456789012:/virtualclusters/virtual-cluster-id/endpoints/managed-endpoint-id"
      ],
      "Condition": {
        "StringEquals": {
          "emr-containers:ExecutionRoleArn": [
            "arn:aws:iam::123456789012:role/emr-on-eks-execution-role"
          ]
        }
      }
    },
    {
      "Sid": "AllowDescribingManagedEndpoint",
      "Effect": "Allow",
      "Action": [
        "emr-containers:DescribeManagedEndpoint"
      ],
      "Resource": [
        "arn:aws:emr-containers:*:123456789012:/virtualclusters/virtual-cluster-id/endpoints/managed-endpoint-id"
      ]
    }
  ]
}
```

------

## Limitações da execução programática
<a name="emr-managed-notebooks-headless-limit"></a>
+ Há suporte para um máximo de 100 execuções simultâneas Região da AWS por conta.
+ Uma execução será encerrada se for executada por mais de 30 dias.
+ A execução programática de cadernos não é compatível com as aplicações interativas do Amazon EMR Serverless.

## Exemplos de execução programática para Cadernos do EMR
<a name="emr-managed-notebooks-headless-examples"></a>

As seções a seguir fornecem vários exemplos de execução programática de notebooks EMR com AWS CLI o Boto3 SDK (Python) e Ruby:
+ [Exemplos de comandos da CLI do caderno no EMR Studio](emr-managed-notebooks-headless-cli.md)
+ [Exemplos de Python para um caderno do EMR](emr-managed-notebooks-headless-python.md)
+ [Exemplos de Ruby para um caderno do EMR](emr-managed-notebooks-headless-ruby.md)

Você também pode executar cadernos parametrizados como parte dos fluxos de trabalho programados com uma ferramenta de orquestração, como o Apache Airflow ou o Amazon Managed Workflows for Apache Airflow (MWAA). Para obter mais informações, consulte [Orchestrating analytics jobs on EMR Notebooks using MWAA](https://aws.amazon.com/blogs/big-data/orchestrating-analytics-jobs-on-amazon-emr-notebooks-using-amazon-mwaa/) no *blog de Big Data da AWS *.