Referência > Referências de etapas de script > Etapas de script diversas > Executar SQL
 

Executar SQL

Executa qualquer instrução SQL em uma fonte de dados ODBC.

Consulte também 

Opções 

Com diálogo especifica se a caixa de diálogo Especificar SQL, a caixa de diálogo Selecionar fonte de dados ODBC e a caixa de diálogo para inserir a senha serão exibidas quando a etapa de script for confirmada.

Fonte de dados de ODBC exibe a caixa de diálogo Selecionar fonte de dados de ODBC. Selecione uma fonte de dados na lista, clique em OK e insira um nome de usuário e uma senha válidos.

Nota  Selecione Salvar nome de usuário e senha se tiver definido Com diálogo como Desativado, do contrário os usuários possivelmente não conseguirão acessar a fonte de dados.

Texto SQL calculado especifica um cálculo para ser usado como consulta SQL.

Texto SQL permite que você insira manualmente uma instrução de consulta SQL.

Compatibilidade 

 

Produto 

Suportado 

FileMaker Pro Advanced 

Sim 

FileMaker Go 

Não 

FileMaker WebDirect 

Parcial 

FileMaker Server 

Parcial 

Produto FileMaker Cloud 

Parcial 

FileMaker Data API 

Parcial 

Publicação na Web personalizada 

Parcial 

Solução runtime 

Não 

Originado em 

FileMaker Pro 6.0 ou anterior

Descrição 

Use esta etapa de script para gerenciar dados em uma fonte de dados ODBC através de uma interface SQL ODBC. Assim você terá mais controle sobre a interação do FileMaker Pro Advanced com fontes de dados ODBC. É possível adicionar várias etapas Executar SQL a um script.

Importante  Consulte Funções Get para obter informações sobre manipulação de erros.

A Função Get (LastExternalErrorDetail) retorna o estado de erro mais recente retornado pela ODBC.

A Função Get (LastError) retorna o último erro do FileMaker Pro Advanced.

Notas 

As instruções SQL têm o limite máximo de 256 K caracteres (512 KB).

Os scripts no lado do servidor, o FileMaker WebDirect, o FileMaker Data API e a Publicação na Web personalizada aceitam esse script apenas se a opção Com diálogo estiver definida como Desativado.

Se você usar a etapa de script Execute SQL para enviar dados ODBC que contêm cadeias Unicode, o driver ODBC deverá aceitar Unicode. Do contrário, os resultados possivelmente serão inconsistentes.

A importação de dados ODBC, a etapa de script Executar SQL e as fontes de dados SQL externas não são aceitas em soluções runtime.

Como o Microsoft SQL Server aceita tipos de campo Unicode e não Unicode, você deve prefixar todas as strings Unicode com um "N" maiúsculo (de "National" no padrão SQL-92). Do contrário, quando uma cadeia Unicode contendo caracteres não inglês é passada para o Microsoft SQL Server, você talvez perca dados que não existem na página de código do Microsoft SQL Server.

A etapa de script Executar SQL executa instruções SQL em fontes de dados ODBC, não em fontes de dados do FileMaker. Para consultar tabelas em fontes de dados do FileMaker usando somente instruções SQL SELECT, use a Função ExecuteSQL.

Exemplo 1 

Atualiza registros na tabela Funcionários de uma fonte de dados ODBC externa.

Executar SQL [Com diálogo: Ativado; Texto SQL: INSERT INTO Funcionários (IDFuncionário, Nome, Sobrenome, Cargo, TelefoneComercial, Salário) VALUES (100, N'Joe', N'Smith', N'Engenharia de software', '987-7000', 100000) UPDATE Funcionários SET Cargo = N'Gerente' WHERE IDFuncionário = 103 DELETE FROM Funcionários WHERE IDFuncionário = 103]

Exemplo 2 

Calcula e executa uma instrução SQL para atualizar registros na tabela Clientes de uma fonte de dados ODBC externa.

Executar SQL [Com diálogo: Ativado; Texto SQL calculado: "INSERT INTO Clientes (Empresa, Sobrenome) VALUES (" & Clientes::Empresa & "," & "N'" & Clientes::Sobrenome & "')"]

Tópicos relacionados 

Referência de etapas de script (lista em ordem alfabética)

Referência de etapas de script (lista de categoria)