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 do bloco

O bloco Executar Comandos SQL utiliza os comandos da linguagem SQL. Esses comandos 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

O bloco Executar Comandos SQL além de aceitar consultas estáticas, onde os parâmetros são passados na própria consulta, também aceita 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. Nesse tipo de consulta, os parâmetros 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.

INSERT INTO nomeTabela VALUES (?,?,?);

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 duas tabelas, "pessoa" e "telefone", no banco de dados "contatos" no dispositivo móvel. Para esta ação utilizamos dois comandos "create table", como mostra o bloco de código abaixo. 

CREATE TABLE PESSOA (idPessoa integer PRIMARY KEY, nome);
CREATE TABLE TELEFONE (idTelefone integer PRIMARY KEY, numero, idPessoa, CONSTRAINT fk_PesTel FOREIGN KEY (idPessoa) REFERENCES PESSOA (idPessoa));

Figura 2 - Criando tabelas utilizando o comando 'create table'

Inserir registros

.

Consultar registros

.

Deletar um registro

.