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.

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

.