Acção de Macro ExecutarSQL

Aplica-se A
Access para Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

Pode utilizar a ação de macro ExecutarSQL para executar uma consulta de ação numa base de dados de ambiente de trabalho do Access com a instrução SQL correspondente. Também pode executar uma consulta de definição de dados.

Nota

Esta ação não será permitida se a base de dados não for fidedigna.

Definição

A ação de macro RunSQL tem os seguintes argumentos.

Argumento de ação Descrição
Instrução SQL A instrução SQL para a consulta de ação ou a consulta de definição de dados que pretende executar. O comprimento máximo desta instrução é de 255 carateres. Este argumento é obrigatório.
Utilizar Transação Selecione Sim para incluir esta consulta numa transação. Selecione Não se não quiser utilizar uma transação. A predefinição é Sim. Se selecionar Não para este argumento, a consulta poderá ser executada mais rapidamente.

Comentários

Pode utilizar consultas de ação para acrescentar, eliminar e atualizar registos e para guardar o conjunto de resultados de uma consulta como uma nova tabela. Pode utilizar consultas de definição de dados para criar, alterar e eliminar tabelas e para criar e eliminar índices. Pode utilizar a ação de macro ExecutarSQL para efetuar estas operações diretamente a partir de uma macro sem ter de utilizar consultas armazenadas.

Se precisar de escrever uma instrução SQL com mais de 255 carateres, utilize o método RunSQL do objeto DoCmd num módulo Visual Basic for Applications (VBA). Pode escrever instruções SQL de até 32.768 carateres no VBA.

As consultas do Access são, na verdade, instruções SQL que são criadas quando cria uma consulta com a grelha de estrutura na janela Consulta. A tabela seguinte mostra as consultas de ação do Access e as consultas de definição de dados e as instruções SQL correspondentes.

Tipo de consulta Instrução SQL
Ação
Acréscimo INSERT INTO
Eliminar ELIMINAR
Criar Tabela SELECIONAR... INTO
Atualização UPDATE
Definição de dados (específica do SQL)
Criar uma tabela CRIAR TABELA
Alterar uma tabela ALTER TABLE
Eliminar uma tabela DROP TABLE
Criar um índice remissivo CRIAR ÍNDICE
Eliminar um índice DROP INDEX

Também pode utilizar uma cláusula IN com estas instruções para modificar dados noutra base de dados.

Nota

Para executar uma consulta selecionar ou consulta cruzada a partir de uma macro, utilize o argumento Ver da ação de macro AbrirQuery para abrir uma consulta selecionar existente ou consulta cruzada na vista folha de dados. Também pode executar consultas de ação existentes e consultas específicas do SQL da mesma forma.

Sugestão

Para ver o equivalente ao SQL de uma consulta do Access, clique em Vista SQL no menu Ver (na barra de estado do Access). Pode utilizar as instruções SQL listadas como modelos para criar consultas para executar com a ação de macro RunSQL . Duplicar uma instrução SQL no argumento Instrução SQL para a ação de macro RunSQL tem o mesmo efeito que executar esta consulta do Access na janela de consulta.