> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/pt/contexto/knowledge-bases/add-data/import-from-sql-database/data-sources/snowflake.md).

# Snowflake

Conecte a um data warehouse Snowflake no AirOps

{% hint style="info" %}
**Lembre-se de adicionar o nosso endereço IP à lista de permissões `52.71.87.39`**

Se a sua base de dados estiver protegida por uma firewall, lembre-se de permitir o acesso de entrada ao endereço IP da AirOps através da porta da sua base de dados.
{% endhint %}

## Parâmetros básicos de ligação

1. **Identificador da conta** - o ID da sua conta Snowflake.
   * Se o URL da sua conta Snowflake for `https://**[en54071.us-east-2.aws](http://en54071.us-east-2.aws)**.snowflakecomputing.com/`, então o identificador da sua conta é **`en54071.us-east-2.aws`.**
   * Também pode encontrar o ID da sua conta Snowflake escrevendo `CURRENT_ACCOUNT()` numa folha de cálculo do Snowflake e executando-a.
2. **Utilizador** - o utilizador do Snowflake com o qual a AirOps se ligará à base de dados. É uma boa prática criar um novo utilizador para a AirOps (consulte as instruções abaixo), mas pode ser utilizado qualquer utilizador com privilégios SELECT. **Os nomes de utilizador do Snowflake diferenciam maiúsculas de minúsculas.**
3. **Armazém** - o armazém do Snowflake ao qual a AirOps se ligará.
4. **Base de dados** - base de dados no armazém Snowflake indicado acima.
5. **Função** (Opcional) - a função Snowflake a utilizar na\
   ligação. Se não for indicada, utilizaremos a função\
   predefinida do utilizador.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-df7523a940911419f06aae17c4bc4a60eea83a7f%2Fsnowflake-01-connection-form.png?alt=media" alt="Snowflake connection form with account, user, warehouse, database, role, and key pair authentication"><figcaption><p>Introduza os detalhes da ligação ao Snowflake e escolha a autenticação por par de chaves.</p></figcaption></figure>

## Métodos de autenticação

A AirOps suporta dois métodos de autenticação para ligações ao Snowflake:

### Autenticação por nome de utilizador e palavra-passe

**Palavra-passe** - palavra-passe do utilizador indicado acima.

### Autenticação por par de chaves (recomendada)

A autenticação por par de chaves oferece maior segurança e é obrigatória quando a MFA está ativada na sua conta Snowflake.

**Chave privada** - a sua chave privada RSA no formato PEM (consulte as instruções de configuração abaixo).

**Frase-passe da chave privada** (Opcional) - necessária apenas se a sua chave privada estiver encriptada.

## Configurar a autenticação por par de chaves

### Passo 1: gerar o par de chaves

Abra a linha de comandos numa janela de terminal.

Gere uma chave privada. Pode gerar uma versão encriptada ou não encriptada da chave privada.

**Para gerar uma versão não encriptada**, pode executar um dos seguintes comandos:

```
openssl genrsa -out rsa_key.pem 2048
```

```
openssl genrsa 2048 | openssl pkcs8 -topk8 -inform PEM -out rsa_key.p8 -nocrypt
```

**Para gerar uma versão encriptada (recomendado)**, execute o comando:

```
openssl genrsa 2048 | openssl pkcs8 -topk8 -v2 <ALGORITHM> -inform PEM -out rsa_key.p8
```

Pode utilizar diferentes algoritmos com a opção de linha de comandos -v1. Estes algoritmos utilizam o algoritmo de encriptação baseado em palavra-passe PKCS#12 e permitem usar algoritmos de encriptação fortes, como o Triple DES ou o RC2 de 128 bits. Pode utilizar os seguintes algoritmos de encriptação:

* `PBE-SHA1-RC2-40`
* `PBE-SHA1-RC4-40`
* `PBE-SHA1-RC2-128`
* `PBE-SHA1-RC4-128`
* `PBE-SHA1-3DES`
* `PBE-SHA1-2DES`

Para utilizar **algoritmos de encriptação mais fortes**, execute o comando:

```
openssl genrsa 2048 | openssl pkcs8 -topk8 -v2 -inform PEM -out rsa_key.p8
```

Pode utilizar algoritmos diferentes com a opção de linha de comandos -v2. Pode utilizar os seguintes algoritmos de encriptação:

* `AES128`
* `AES256`
* `DES3`

### Passo 2: gerar a chave pública

Na linha de comandos, gere a chave pública indicando a versão correta da chave privada que gerou. Pode executar um dos seguintes comandos:

Se utilizou o comando openssl genrsa -out rsa\_key.pem 2048 para criar a chave privada, execute:

```
openssl rsa -in rsa_key.pem -pubout -out rsa_key.pub
```

Se utilizou o comando openssl genrsa 2048 | openssl pkcs8 -topk8 -inform PEM -out rsa\_key.p8 -nocrypt para criar a chave privada, execute:

```
openssl rsa -in rsa_key.p8 -pubout -out rsa_key.pub
```

### Passo 3: atribuir a chave pública ao utilizador do Snowflake

Numa folha de cálculo do Snowflake, execute o comando:

```
ALTER USER <USERNAME> SET RSA_PUBLIC_KEY='<PUBLIC_KEY>';
```

Substitua \<USERNAME> pelo seu nome de utilizador do Snowflake e \<PUBLIC\_KEY> pelo conteúdo do ficheiro da chave pública (excluindo as linhas -----BEGIN PUBLIC KEY----- e -----END PUBLIC KEY-----).

### Passo 4: configurar a ligação do AirOps

1. Selecione «Autenticação por par de chaves» como método de autenticação
2. Copie e cole a chave privada no campo «Chave privada» (inclua as linhas -----BEGIN PRIVATE KEY----- e -----END PRIVATE KEY-----)
3. Se a chave privada estiver encriptada, introduza a frase-passe no campo «Frase-passe da chave privada»
4. Preencha os restantes campos da ligação e teste a ligação

## Configurar o utilizador e a função (para novos utilizadores)

Para adicionar uma base de dados Snowflake como fonte de dados no AirOps, utilize um utilizador existente ou crie um utilizador com acesso de **leitura** às tabelas, vistas e esquemas que pretende aceder a partir do AirOps:

### 1. Criar a função AirOps

```sql
CREATE ROLE IF NOT EXISTS AIROPS_ROLE COMMENT = "Airops default role";
```

### 2. Criar o utilizador AirOps e atribuir-lhe a função

<pre class="language-sql"><code class="lang-sql"><strong>CREATE USER AIROPS_USER
</strong>	password = '&#x3C;secure-password>'
	first_name = 'AirOps'
	last_name = 'User'
	default_warehouse = '&#x3C;warehouse>' 
	default_namespace = '&#x3C;database>.&#x3C;schema>'
	default_role = AIROPS_ROLE;

GRANT ROLE AIROPS_ROLE TO USER AIROPS_USER;
GRANT ROLE AIROPS_ROLE TO ROLE SYSADMIN;
</code></pre>

### 3. Conceder privilégios USAGE à função AirOps

```sql
GRANT USAGE ON WAREHOUSE COMPUTE_WH TO ROLE AIROPS_ROLE;

GRANT USAGE ON DATABASE "<database>" TO ROLE AIROPS_ROLE;

GRANT USAGE ON ALL SCHEMAS IN DATABASE "<database>" TO ROLE AIROPS_ROLE;
GRANT USAGE ON FUTURE SCHEMAS IN DATABASE "<database>" TO ROLE AIROPS_ROLE;

GRANT SELECT ON ALL TABLES IN DATABASE "<database>" TO ROLE AIROPS_ROLE;
GRANT SELECT ON FUTURE TABLES IN DATABASE "<database>" TO ROLE AIROPS_ROLE;

GRANT SELECT ON ALL VIEWS IN DATABASE "<database>" TO ROLE AIROPS_ROLE;
GRANT SELECT ON FUTURE VIEWS IN DATABASE "<database>" TO ROLE AIROPS_ROLE;
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/pt/contexto/knowledge-bases/add-data/import-from-sql-database/data-sources/snowflake.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
