# Hierarquia de recursos

> A hierarquia de recursos do StackQL: como providers, serviços, recursos e métodos mapeiam APIs na nuvem e de SaaS para tabelas SQL consultáveis.

Source: https://stackql.io/pt-br/getting-started/resource-hierarchy

Veja também:  
[[` SHOW `]](/language-spec/show) [[` DESCRIBE `]](/language-spec/describe)

* * * 

Os objetos do StackQL são representados na hierarquia a seguir, com um exemplo que usa o provider do Google Cloud:

### Usar a notação de objetos do StackQL

Essa hierarquia é expressa na notação de objetos `<provider>.<service>.<resource>` no contexto de um determinado provider; veja aqui um exemplo dessa notação de objetos usada em uma instrução [`SELECT`](/language-spec/select):  

```sql
-- Selecting all resources deployed within a service using a basic SELECT statement
SELECT * FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';
```

:::note

Se um recurso ou serviço tiver um ponto (`.`) no nome, use o caractere de crase (__`__) para delimitar o nome do recurso, por exemplo:

```sql
SELECT * FROM google.container.`projects.zones.clusters.nodePools`;
```

:::

### Mostrar os serviços de um provider

Os serviços de um provider podem ser listados com o comando [`SHOW SERVICES`](/language-spec/show), como mostrado aqui:  

```sql
-- Returns all of the available services in a cloud provider
SHOW SERVICES IN google;
```  

### Mostrar os recursos de um serviço

Da mesma forma, os recursos de um serviço podem ser listados com [`SHOW RESOURCES`](/language-spec/show), como mostrado aqui:

```sql
-- Returns all of the available resources in a cloud provider service
SHOW RESOURCES IN google.compute;
```  

### Mostrar os campos de um recurso

Os campos de um recurso podem ser exibidos com uma instrução [`DESCRIBE`](/language-spec/describe), como mostrado aqui:

```sql
-- Returns all of the available fields in a resource
DESCRIBE google.compute.instances;
```

### Mostrar os métodos executáveis de um recurso

Os métodos disponíveis para um recurso podem ser exibidos com um comando [`SHOW METHODS`](/language-spec/show), como mostrado aqui:

```sql
-- Show all of the available methods for a resource
SHOW METHODS IN google.compute.instances;
```
