Referência > Referências de etapas de script > Etapas de script diversas > Executar SQL
 
Executar SQL
Propósito 
Executa qualquer instrução SQL em uma fonte de dados ODBC.
Consulte também 
Formato 
Executar SQL [Com diálogo: Ativado/Desativado; ODBC: <nome da fonte de dados>; <SQL nativa
ou calculada>
]
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 
 
Onde a etapa de script é executada 
Formato 
FileMaker Pro 
Sim 
FileMaker Server 
Parcial 
FileMaker Go 
Não 
Publicação na Web personalizada 
Parcial 
FileMaker WebDirect 
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 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 Get ( LastExternalErrorDetail ) função retorna o estado de erro mais recente retornado pela ODBC.
A Get ( LastError ) função retorna o último erro do FileMaker Pro.
Notas 
As instruções SQL têm o limite máximo de 256 K caracteres (512 KB).
O FileMaker Server, FileMaker WebDirect e 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 de tempo de execução criadas com o FileMaker Pro Advanced.
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.
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 categorias)