# JSON_TYPE

> Função JSON_TYPE no StackQL: o tipo (object, array, text, integer, real, true, false ou null) do elemento mais externo de um valor JSON, ou de um caminho dentro dele.

Source: https://stackql.io/pt-br/language-spec/functions/json/json_type

Retorna o tipo de dados do elemento mais externo de um objeto ou array JSON de entrada e de um caminho.  

Veja também:  
[[` SELECT `]](/language-spec/select) [[` DESCRIBE `]](/language-spec/describe) [[` JSON_EXTRACT `]](/language-spec/functions/json/json_extract) [[ Tipos de dados ]](/language-spec/data-types)

* * * 

:::tip 

Use a instrução [**DESCRIBE**](/language-spec/describe) para localizar os tipos de dados `array` ou `object` que podem ser usados com as funções JSON do StackQL.

:::

:::note 

A função `json_type` é implementada como a função `json_typeof` se você usar o stackql com um backend SQL `postgres`

:::

## Sintaxe

```sql
SELECT JSON_TYPE(json_array_or_object, json_path) 
FROM <multipartIdentifier>;
```

## Argumentos

__*json_array_or_object*__  
Um array ou objeto JSON.

__*json_path*__  
O caminho JSON para um array ou objeto contido em *json_array_or_object*.  Consulte [jsonpath.com](https://jsonpath.com/).

> Se *json_path* não existir em *json_array_or_object*, a função retorna `NULL`.

> A função `json_type()` gera um erro se algum dos seus argumentos não estiver bem formado.

## Valor(es) retornado(s)
Uma string que representa o tipo de dados resolvido.

> Os tipos de dados incluem `null`, `true`, `false`, `integer`, `real`, `text`, `array` ou `object`.

* * *

## Exemplos

### Retornar o tipo de dados de um campo aninhado em um objeto ou array JSON

```sql
SELECT json_type(disks, '$[0].licenses[0]') as datatype
FROM google.compute.instances 
WHERE project = 'stackql-demo' 
AND zone = 'australia-southeast1-a';
/* returns text */
```

Para obter mais informações, consulte [https://www.sqlite.org/json1.html#jtype](https://www.sqlite.org/json1.html#jtype)
