SQL EXECUTE SCRIPT

4D v20 R7

SQL

SQL EXECUTE SCRIPT


SQL EXECUTE SCRIPT ( rotaScript ; açãoErro {; nomeAtrib ; valorAtrib} {; nomeAtrib2 ; valorAtrib2 ; ... ; nomeAtribN ; valorAtribN} )

Parâmetro	Tipo	Descrição
rotaScript	Texto	Nome completo da rota do arquivo que contém o script SQL a ser executado
açãoErro	Inteiro longo	Ação a executar em caso de erro durante a execução do script
nomeAtrib	Texto	Nome do atributo a usar
valorAtrib	Texto	Valor do atributo

Descrição

O comando SQL EXECUTE SCRIPT permite executar uma série de instruções SQL localizadas no arquivo de script designado por rotaScript.
Este comando apenas pode ser executado em uma máquina local (4D local ou procedimento armazenado em 4D Server). Funciona com o banco de dados atual (banco interno ou externo)

Nota: este comando não pode ser utilizado com uma conexão externa que seja aberta diretamente ou através de ODBC.

Passe no parâmetro rotaScript a rota de acesso completa do arquivo texto que contém as instruções SQL a executar. A rota de acesso deve ser expressa utilizando a sintaxe do Sistema atual. Se passa uma string vazia ("") em rotaScript, uma caixa de diálogo é mostrada de abertura padrão de maneira que o usuário possa selecionar o arquivo de script a executar.

Nota: os comandos SQL EXPORT DATABASE e SQL EXPORT SELECTION geram automaticamente este arquivo de script.

O parâmetro açãoErro é utilizado para configurar o funcionamento do comando quando ocurre um erro durante a execução do script. Pode passar uma das seguintes três constantes, localizadas no temaSQL:

Constante	Tipo	Valor	Comentário
SQL On error abort	Inteiro longo	1	Em caso de erro, 4D detém imediatamente a execução de script.
SQL On error confirm	Inteiro longo	2	No caso de erro, 4D mostra uma caixa de diálogo que descreve o erro e permite ao usuário interromper ou continuar a execução do script.
SQL On error continue	Inteiro longo	3	Em caso de erro, 4D o ignora e continua a execução de script.

Os parâmetros nomAtrib e valAtrib devem ser passados em pares. Estes parâmetros permitem definir os atributos específicos para a execução do script. Na versão atual de 4D, um único atributo pode ser passado em nomAtrib, disponível através da constante abaixo, localizada no tema SQL :

Constante

Tipo

Valor

Comentário

SQL use access rights

Cadeia

SQL_Use_Access_Rights

Permite restringir os direitos de acesso a aplicar durante a execução dos comandos SQL do script. Quando utilizar este atributo, deve passar 0 ou 1 em attribValue:

attribValue = 1: 4D utiliza os direitos de acesso de usuário 4D atual.
attribValue = 0 (ou atributo não definido): 4D não restringe o acesso, são utilizados os direitos do Designer.

Se o arquivo de registro de pedidos de 4D estiver ativo (através dos seletores 28 ou 45 do comando SET DATABASE PARAMETER), cada comando SQL executado gerará uma entrada com a seguinte informação:

Tipo de comando SQL

Número de registros afetados pelo comando
Duração de execução do comando
Para cada erro encontrado:
- ou o código de erro
- ou o texto do erro se estiver disponível

Se o script for executado corretamente (nenhum erro ocorre), a variável Sistema OK assume o valor 1. No evento de um erro, a variável Sistema OK assume ou não o valor 0 em função do parâmetro açãoErro:

    * Se açãoErro é SQL On erro abort (valor 1), OK assume o valor 0.
    * Se açãoErro é SQL On erro confirm (valor 2), OK assume o valor 0 se o usuário escolher parar a operação e 1 se escolher continuar.
    * Se açãoErro é SQL On erro continue (valor 3), a variável OK sempre assume o valor 1.

Nota: Se utilizar este comando para executar ações consumidoras de memória tales como importação massiva de dados, pode considerar chamar ao comando SQL ALTER DATABASE para desativar temporáriamente as opções SQL.