Executa instruções no formato de comandos na linguagem SQL. Este bloco utiliza recursos do Apache Cordova, para mais informações de configuração e funcionamento, verifique a documentação oficial do Cordova.
![](/download/attachments/234677484/blocoExecutarComandoSql.png?version=1&modificationDate=1693838020000&api=v2)
Figura 1 - Bloco Executar Comando SQL
Compatibilidade
- Bloco cliente: cronapi.cordova.database.executeSql()
Retorno
O retorno do bloco irá depender do comando SQL executado.
Parâmetros
Nome do Banco
Nome do banco de dados no qual serão executados os comandos SQL.
- Posição: 1
- Inglês: Database Name
- Tipo: Texto / String
- Exemplo: "contatos"
SQL
Comando SQL a ser executado no banco de dados informado anteriormente.
- Posição: 2
- Inglês: SQL
- Tipo: Texto / String
- Exemplo: "CREATE TABLE PESSOA (idPessoa integer PRIMARY KEY, nome);"
Lista de parâmetros
Lista de parâmetros a ser adicionada ao comando. Neste parâmetro, para criar a lista, pode ser utilizado o bloco criar lista com.
- Posição: 3
- Inglês: List of parameters
- Tipo: Objeto / Object
- Exemplo: Uso do bloco criar lista com.
Características..
Os Comandos SQL são agrupados em 4 categorias, sendo DDL e DML, as duas principais:
Linguagem de Definição de Dados (DDL) - Comandos desse tipo são utilizados pra criar, modificar e apagar a estrutura dos objetos de um banco de dados. Os comandos são: CREATE, ALTER, DROP, RENAME e TRUNCATE.
Linguagem de Manipulação de Dados (DML) - Comandos desse tipo são utilizados para armazenar, obter, modificar e apagar os dados. Os comandos são: INSERT, SELECT, UPDATE e DELETE.
Consultas dinâmicas
As consultas SQL dinâmicas são úteis quando os argumentos a serem utilizados na consulta são obtidos durante a execução do programa, sendo frequentemente recuperados através da interação do usuário com o sistema. Para o caso da função Executar comando SQL, os parâmetros incluídos na consulta são passados de forma dinâmica de acordo com o exemplo abaixo, onde o símbolo (?) significa o valor a ser obtido e agregado ao comando SQL a ser executado.
Exemplo
Os tópicos abaixo mostram alguns exemplos de uso do bloco Executar Comando SQL. Neles veremos os principais comandos SQL utilizados. O banco de dados utilizado nos exemplos é o mesmo que foi criado na documentação do bloco Criar banco de dados, consulte-a para mais detalhes.
Criar tabela
No exemplo abaixo estamos criando uma tabela no banco de dados local do dispositivo móvel.
CREATE TABLE Pessoa (idPessoa integer PRIMARY KEY, nome);
CREATE TABLE TELEFONE (idTel integer PRIMARY KEY, num, idPessoa, CONSTRAINT fk_PesTel FOREIGN KEY (idPessoa) REFERENCES pessoa (idPessoa));
Inserir registros
.
Consultar registros
.
Deletar um registro
.