SQLCURSOR

Esta página de ajuda é para Studio. Estas informações também estão disponíveis para Desktop Studio.

Icon of SQLCursor: gray database with code brackets

Envia uma instrução SQL (Structured Query Language) para um servidor de banco de dados e retorna um resultado de várias linhas.

Dependências

  • Use Sqlcursor para a mesma finalidade que Sqlselect quando múltiplo linhas forem esperadas.
  • Esta ação não recupera todas as linhas de uma vez. Em vez disso, o conjunto DE dados é aberto e mantido aberto para acesso repetitivo.
  • Como em Sqlcursor, cada coluna é armazenada em uma variável com o mesmo nome da coluna. Inicialmente, o primeiro registro será buscado. Para buscar registros consecutivos, execute Sqlnext repetidamente até que Sqlnext acione sua condição de ramificação End of Dataset.
  • Se o script não precisar continuar buscando todos os registros, posicione a ação Sqlclose após a condição de ramificação End of Dataset. Isso fechará manualmente o Conjunto DE dados. Isso garante que a memória do banco de dados seja liberada e os bloqueios potenciais de registro não serão deixados ativos.

Tipos de script suportados

Um quadrado com uma linha saindo dele e indo em direção a três outros quadrados.

Icon of gray-green envelope

Ícone de balão de fala verde escuro

Icon of purple telephone handset

Ícone do símbolo de correio de voz na cor marrom-enferrujado, composto por dois círculos unidos por uma linha

Icon of pink document with lines of text

Ícone de um telefone celular verde com um balão de fala na tela

Genérico

E-mail Chat Telefone Correio de voz Item de trabalho SMS

Propriedades de entrada

Estas propriedades definem dados que a ação usa durante a execução.

Propriedade

Descrição

Adicionar legenda

Insira uma frase curta que identifique exclusivamente esta ação no script. A legenda aparece na tela do script no ícone da ação.

Consulta SQL

A Instrução SQL que será enviada ao servidor de banco de dados. É esperado que esta declaração retorne registros.

Variáveis globais

Não utilizado.
Publish

Publica uma variável e um valor do sobrenome que é recuperado. Por exemplo, se houvesse três nomes recuperados, apenas os dados do sobrenome seriam publicados.

Limite de tempo em seg

O número de segundos que a ação aguarda para ser executada antes de atingir o tempo limite. O valor deve estar entre 0 e 60.

Condições do ramo de resultado

As condições de ramificação de resultado permitem que você crie ramificações no seu script para tratar diferentes resultados quando uma ação é executada.

Condição

Descrição

Padrão

Path taken unless the script meets a condition that requires it to take one of the other branches. It is also taken if the action's other branches are not defined.
NoRecords Path taken if there are no values for the specified properties.
Erro Path taken when the action fails to execute properly. For example, when there is an unexpected problem such as poor connectivity, syntax errors, and so on. The _ERR variable, with a single underscore character, should be populated with a condensed explanation of the problem.