Ação da macro ExecutarSQL

Aplica-se ao: Access 2013, Office 2013

Você pode usar a ação RunSQL para executar uma consulta de ação do Access usando a instrução SQL correspondente. Pode também executar uma consulta de definição de dados.

Observação

Essa ação não será permitida se o banco de dados não for confiável.

Setting

A ação ExecutarSQL tem os seguintes argumentos.

Argumento da ação	Descrição
Instrução SQL	A instrução SQL da consulta ação ou da consulta de definição de dados a ser executada. O tamanho máximo dessa instrução é de 255 caracteres. Este é um argumento obrigatório.
Usar transação	Selecione Sim para incluir essa consulta em uma transação. Selecione Não se não quiser usar uma transação. O padrão é Sim. Se você selecionar Não para este argumento, a consulta poderá ser executada mais rapidamente.

Comentários

Você pode usar consultas ação para acrescentar, excluir e atualizar registros e para salvar o conjunto de resultados de uma consulta como uma nova tabela. As consultas de definições de dados podem ser usadas para criar, alterar e excluir tabelas, e para criar e excluir índices. Use a ação ExecutarSQL para executar essas operações diretamente em uma macro, sem precisar usar consultas armazenadas.

Se precisar digitar uma instrução SQL com mais de 255 caracteres, use o método RunSQL do objeto DoCmd em um módulo do VBA (Visual Basic for Applications). No VBA, é possível digitar instruções SQL com até 32.768 caracteres.

As consultas do Access, na verdade, são instruções SQL criadas durante a criação de uma consulta com a grade de design na janela Consulta. A tabela a seguir mostra as consultas ação e as consultas de definições de dados, do Access, e as respectivas instruções SQL.

Tipo de consulta	Instrução SQL
Action
Append	INSERT INTO
Excluir	DELETE
Make-table	SELECIONE... EM
Atualizar	UPDATE
Definição de dados (específica de SQL)
Criar uma tabela	CREATE TABLE
Alterar uma tabela	ALTER TABLE
Excluir uma tabela	DROP TABLE
Criar um índice	CREATE INDEX
Excluir um índice	DROP INDEX

Você também pode usar uma cláusula IN com essas instruções para modificar dados em outro banco de dados.

Observação

[!OBSERVAçãO] Para executar uma consulta seleção ou uma consulta de tabela de referência cruzada em uma macro, use o argumento Exibir da ação AbrirConsulta para abrir uma consulta seleção ou uma consulta de tabela de referência cruzada existente no modo Folha de Dados. Consultas ação e consultas específicas de SQL existentes também podem ser executadas dessa mesma forma.