

# Criar instruções em PartiQL
<a name="workbench.querybuilder.partiql"></a>

Para usar o NoSQL Workbench para criar declarações do [PartiQL para DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.html), selecione **Editor PartiQL** no canto superior da interface de usuário do NoSQL Workbench.

É possível criar os tipos de instrução PartiQL a seguir no criador de operações.

**Topics**
+ [Instruções em Singleton](#workbench.querybuilder.partiql.single)
+ [Transações](#workbench.querybuilder.partiql.transaction)
+ [Batch](#workbench.querybuilder.partiql.batch)

## Instruções em Singleton
<a name="workbench.querybuilder.partiql.single"></a>

Para executar ou gerar código para uma instrução PartiQL, faça o seguinte:

1. Selecione **Editor PartiQL** próximo à parte superior da janela.

1. Insira uma [PartiQL statement](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.statements.html) (Instrução PartiQL) válida.

1. Se a sua instrução usar parâmetros:

   1. Escolha **Optional request parameters** (Parâmetros de solicitação opcionais).

   1. Escolha **Add new parameters** (Adicionar novos parâmetros).

   1. Insira o tipo e o valor do atributo.

   1. Para adicionar parâmetros extras, repita as etapas b e c.

1. Se desejar gerar código, escolha **Generate code** (Gerar código).

   Selecione a linguagem desejada nas guias exibidas. Agora você pode copiar esse código e usá-lo na sua aplicação.

1. Se desejar que a operação seja executada imediatamente, escolha **Run** (Executar).

1. Se desejar salvar esta operação para uso posterior, escolha **Save operation** (Salvar operação). Depois, insira um nome para sua operação e escolha **Save** (Salvar).

## Transações
<a name="workbench.querybuilder.partiql.transaction"></a>

Para executar ou gerar código para uma transação do PartiQL, faça o seguinte:

1. Selecione **PartiQLTransaction** no menu suspenso **Mais operações**.

1. Escolha **Add a new statement** (Adicionar uma nova instrução).

1. Insira uma [PartiQL statement](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.statements.html) (Instrução PartiQL) válida.
**nota**  
Não há suporte a operações de leitura e gravação na mesma solicitação de transação PartiQL. Uma instrução SELECT não pode estar presente na mesma solicitação que instruções INSERT, UPDATE e DELETE. Consulte [Executar transações com PartiQL para DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.multiplestatements.transactions.html) para obter mais detalhes.

1. Se a sua instrução usar parâmetros

   1. Escolha **Optional request parameters** (Parâmetros de solicitação opcionais).

   1. Escolha **Add new parameters** (Adicionar novos parâmetros).

   1. Insira o tipo e o valor do atributo.

   1. Para adicionar parâmetros extras, repita as etapas b e c.

1. Para adicionar mais instruções, repita as etapas 2 a 4.

1. Se desejar gerar código, escolha **Generate code** (Gerar código).

   Selecione a linguagem desejada nas guias exibidas. Agora você pode copiar esse código e usá-lo na sua aplicação.

1. Se desejar que a operação seja executada imediatamente, escolha **Run** (Executar).

1. Se desejar salvar esta operação para uso posterior, escolha **Save operation** (Salvar operação). Depois, insira um nome para sua operação e escolha **Save** (Salvar).

## Batch
<a name="workbench.querybuilder.partiql.batch"></a>

Para executar ou gerar código para um lote de PartiQL, faça o seguinte:

1. Selecione **PartiQLBatch** no menu suspenso **Mais operações**.

1. Escolha **Add a new statement** (Adicionar uma nova instrução).

1. Insira uma [PartiQL statement](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.statements.html) (Instrução PartiQL) válida.
**nota**  
 Não há suporte a operações de leitura e gravação na mesma solicitação de lote de PartiQL, o que significa que uma instrução SELECT não pode estar na mesma solicitação que instruções INSERT, UPDATE e DELETE. Operações de gravação no mesmo item não são permitidas. Assim como na operação BatchGetItem, apenas operações de leitura singleton são aceitas. Operações de verificação e consulta não são aceitas. Consulte [Executar operações em lote com PartiQL para DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.multiplestatements.batching.html) para obter mais detalhes.

1. Se a sua instrução usar parâmetros:

   1. Escolha **Optional request parameters** (Parâmetros de solicitação opcionais).

   1. Escolha **Add new parameters** (Adicionar novos parâmetros).

   1. Insira o tipo e o valor do atributo.

   1. Para adicionar parâmetros extras, repita as etapas b e c.

1. Para adicionar mais instruções, repita as etapas 2 a 4.

1. Se desejar gerar código, escolha **Generate code** (Gerar código).

   Selecione a linguagem desejada nas guias exibidas. Agora você pode copiar esse código e usá-lo na sua aplicação.

1. Se desejar que a operação seja executada imediatamente, escolha **Run** (Executar).

1. Se desejar salvar esta operação para uso posterior, escolha **Save operation** (Salvar operação). Depois, insira um nome para sua operação e escolha **Save** (Salvar).