Pular para o conteúdo principal
Página traduzida

Esta página foi traduzida do inglês com assistência de IA. Se houver diferenças entre as duas, a versão em inglês é a referência.

Estrutura léxica

Veja também:
[ Hierarquia de recursos do StackQL ] [ Palavras-chave ] [ Tipos de dados ] [ DESCRIBE ]

A estrutura léxica e a gramática do StackQL seguem o modelo da implementação da linguagem do MySQL (uma adaptação do padrão ANSI SQL-92), com algumas extensões. As instruções do StackQL servem para consultar recursos na nuvem (com a gramática de SELECT) ou para criar, modificar ou excluir infraestrutura com instruções padrão da linguagem de manipulação de dados (DML), como INSERT, UPDATE, REPLACE e DELETE. Além disso, operações que não são DML, como, por exemplo, iniciar uma instância ou obter um objeto de um bucket do AWS S3 ou colocar um objeto nele, são implementadas como procedimentos integrados do provider (semelhantes aos procedimentos armazenados de um SGBD). Os procedimentos integrados do provider são invocados com a instrução EXEC.

A linguagem SQL de domínio específico do StackQL permite programar infraestrutura de forma tanto declarativa quanto procedural.


Sintaxe​

As operações do StackQL são compostas por uma ou mais instruções terminadas em ponto e vírgula (;). As instruções incluem palavras-chave, identificadores, parâmetros e valores; um exemplo de instrução do StackQL usada para criar um disco de 10GB no GCP seria:

INSERT INTO google.compute.disks (project, zone, name, sizeGb)
SELECT 'myProject', 'australia-southeast1-a', 'my10GbDisk', 10;

No exemplo acima, INSERT, INTO e SELECT são palavras-chave, google.compute.disks é um identificador, project, zone, name, sizeGb são parâmetros e 'myProject', 'australia-southeast1-a', 'my10GbDisk', 10 são valores.

Palavras-chave​

As palavras-chave não diferenciam maiúsculas de minúsculas, ou seja, INSERT e insert são tratadas da mesma forma; no entanto, por convenção, elas costumam ser escritas em maiúsculas. A lista completa de palavras-chave está na seção Palavras-chave.

Identificadores​

Os identificadores são símbolos que representam objetos na hierarquia de recursos de um provedor de nuvem. Os identificadores são compostos por várias partes; para obter mais informações sobre identificadores, consulte o tópico Hierarquia de recursos do StackQL.

Parâmetros e valores​

Os parâmetros são especificados pelo recurso; você pode encontrá-los com uma instrução DESCRIBE para um determinado recurso do provedor de nuvem. Os valores são objetos escalares ou complexos tipados, que correspondem aos parâmetros. Para obter mais informações sobre parâmetros e valores, consulte os tópicos DESCRIBE e Tipos de dados.

Variáveis​

Um identificador com prefixo de cifrão, como $region, desreferencia uma variável de sessão atribuída com SET; ele é substituído pelo valor tipado da variável antes que a instrução seja planejada. Um '$region' entre aspas simples é um literal de string. Em uma cláusula FROM, uma $variable é resolvida para um nome de relação, e IDENTIFIER($variable) é resolvido para um nome de coluna em posições de expressão. Um caminho entre aspas duplas com prefixo de cifrão, como "$.auth.aws.password", é um alvo de configuração de runtime aceito por SET e UNSET. As variáveis de sessão estão disponíveis a partir do StackQL v1.0; consulte Variáveis de sessão.

Operadores​

|| é o operador de concatenação de strings e tem precedência maior que os operadores de comparação. OR é a disjunção booleana. As versões do StackQL anteriores à v1.0 reconheciam || como o token léxico OR.

Comentários​

O StackQL oferece suporte a comentários de várias linhas e comentários em linha nas instruções do StackQL; veja exemplos de comentários a seguir:

/* This
Is a
Multiline
Comment
*/

--This is an inline comment