[comment]: # translation:outdated

[comment]: # ({710cea74-710cea74})
# 11 Oracle database setup

[comment]: # ({/710cea74-710cea74})

[comment]: # ({c3411fd2-c3411fd2})
#### Visão geral

Esta seção contém instruções para criar banco de dados Oracle e
configurando conexões entre o banco de dados e o servidor Zabbix, proxy,
e front-end.

[comment]: # ({/c3411fd2-c3411fd2})

[comment]: # ({2fd36a67-2fd36a67})
### Criação de banco de dados

Assumimos que existe um usuário de banco de dados *zabbix* com senha *password*
e tem permissões para criar objetos de banco de dados no serviço ORCL localizado
no servidor de banco de dados Oracle *host*. Zabbix requer um banco de dados Unicode
conjunto de caracteres e um conjunto de caracteres nacional `UTF8`. Verifique a corrente
definições:

    sqlplus> selecione parâmetro, valor de v$nls_parameters onde parâmetro='NLS_CHARACTERSET' ou parâmetro='NLS_NCHAR_CHARACTERSET';

Agora prepare o banco de dados:

    shell> cd /path/to/zabbix-sources/database/oracle
    shell> sqlplus zabbix/senha@oracle_host/ORCL
    sqlplus> @schema.sql
    # pare aqui se você estiver criando um banco de dados para o proxy Zabbix
    sqlplus> @imagens.sql
    sqlplus> @data.sql

::: dica
Por favor, defina o parâmetro de inicialização
CURSOR\_SHARING=FORCE para melhor desempenho.
:::

[comment]: # ({/2fd36a67-2fd36a67})

[comment]: # ({db4ecc98-db4ecc98})
### Conexão configurada

O Zabbix suporta dois tipos de identificadores de conexão (métodos de conexão):

- Fácil Conexão
- Nome do serviço de rede

Parâmetros de configuração de conexão para servidor Zabbix e proxy Zabbix
pode ser definido nos arquivos de configuração. Parâmetros importantes para o
servidor e proxy são *DBHost*, *DBUser*, *DBName* e *DBPassword*. O
mesmos parâmetros são importantes para o frontend: *$DB\["SERVER"\]*,
*$DB\["PORT"\]*, *$DB\["DATABASE"\]*, *$DB\["USER"\]*,
*$DB\["SENHA"\]*.

O Zabbix usa a seguinte sintaxe de string de conexão:

    {DBUser/DBPassword[@<connect_identifier>]}

<connect\_identifier> pode ser especificado na forma de "Net
Nome do serviço" ou "Conexão fácil".

    @[[//]Host[:Porta]/<service_name> | <net_service_name>]

[comment]: # ({/db4ecc98-db4ecc98})

[comment]: # ({ed80a373-ed80a373})
#### Conexão fácil

O Easy Connect usa os seguintes parâmetros para se conectar ao banco de dados:

- *Host* - o nome do host ou endereço IP do computador do servidor de banco de dados
    (parâmetro DBHost no arquivo de configuração).
- *Port* - a porta de escuta no servidor de banco de dados (parâmetro DBPort
    no arquivo de configuração; se não for definido a porta padrão 1521 será
    usado).
- <service\_name> - o nome do serviço do banco de dados que você deseja
    access (parâmetro DBName no arquivo de configuração).

**Exemplo:**

Parâmetros de banco de dados definidos no arquivo de configuração do servidor ou proxy
(zabbix\_server.conf e zabbix\_proxy.conf):

    DBHost=localhost
    DBPort=1521
    DBUser = meu nome de usuário
    DBName=ORCL
    DBPassword=minhasenha

String de conexão usada pelo Zabbix para estabelecer a conexão:

    DBUser/DBPassword@DBHost:DBPort/DBName

Durante a instalação do frontend do Zabbix, defina os parâmetros correspondentes em
a etapa *Configure DB connection* do assistente de configuração:

- Host do banco de dados: localhost
- Porta do banco de dados: 1521
- Nome do banco de dados: ORCL
- Usuário: meuusername
- Senha: minha senha

![](../../../../assets/en/manual/appendix/install/oracle_easy_connect.png){width="600"}

Alternativamente, esses parâmetros podem ser definidos na configuração do frontend
arquivo (zabbix.conf.php):

    $DB["TYPE"] = 'ORACLE';
    $DB["SERVER"] = 'localhost';
    $DB["PORT"] = '1521';
    $DB["DATABASE"] = 'ORCL';
    $DB["USER"] = 'meuusuário';
    $DB["SENHA"] = 'minha senha';

[comment]: # ({/ed80a373-ed80a373})

[comment]: # ({fe8fa72a-fe8fa72a})
#### Nome do serviço de rede

Desde o Zabbix 5.4.0 é possível conectar ao Oracle usando net
Nome do Serviço.

<net\_service\_name> é um nome simples para um serviço que resolve
para um descritor de conexão.

Para usar o nome do serviço para criar uma conexão, este serviço
nome deve ser definido no arquivo tnsnames.ora localizado em ambos os
servidor de banco de dados e os sistemas cliente. A maneira mais fácil de ter certeza
que a conexão terá sucesso é definir a localização de
tnsnames.ora na variável de ambiente TNS\_ADMIN. O padrão
a localização do arquivo tnsnames.ora é:

    $ORACLE_HOME/network/admin/

Um exemplo simples de arquivo tnsnames.ora:

    ORCL =
      (DESCRIÇÃO =
        (ENDEREÇO = (PROTOCOLO = TCP)(HOST = host local)(PORT = 1521))
        (CONNECT_DATA =
          (SERVIDOR = DEDICADO)
          (SERVICE_NAME = ORCL)
        )
      )

Para definir parâmetros de configuração para a conexão "Net Service Name"
método, use uma das seguintes opções:

- Defina um parâmetro DBHost vazio e defina DBName como de costume:

```{=html}
<!-- -->
```
    DBHost=
    DBName=ORCL

- Defina ambos os parâmetros e deixe ambos vazios:

```{=html}
<!-- -->
```
    DBHost=
    DBName=

No segundo caso, a variável de ambiente TWO\_TAKS deve ser configurada. Isto
especifica o serviço Oracle remoto padrão (nome do serviço). Quando isso
variável é definida, o conector se conecta ao banco de dados especificado por
usando um ouvinte Oracle que aceita solicitações de conexão. Esta variável
é para uso apenas em Linux e UNIX. Use a variável de ambiente LOCAL
para Microsoft Windows.

**Exemplo:**

Conecte-se a um banco de dados usando o Net Service Name definido como ORCL e o padrão
porta. Parâmetros de banco de dados definidos no arquivo de configuração do servidor ou proxy
(zabbix\_server.conf e zabbix\_proxy.conf):

    DBHost=
    #DBPort=
    DBUser = meu nome de usuário
    DBName=ORCL
    DBPassword=minhasenha

Durante a instalação do frontend do Zabbix, defina os parâmetros correspondentes em
a etapa *Configure DB connection* do assistente de configuração:

- Hospedagem do banco de dados:
- Porta do banco de dados: 0
- Nome do banco de dados: ORCL
- Usuário: meuusername
- Senha: minha senha

![](../../../../assets/en/manual/appendix/install/oracle_service_name.png){width="600"}

Alternativamente, esses parâmetros podem ser definidos na configuração do frontend
arquivo (zabbix.conf.php):

    $DB["TYPE"] = 'ORACLE';
    $DB["SERVIDOR"] = '';
    $DB["PORT"] = '0';
    $DB["DATABASE"] = 'ORCL';
    $DB["USER"] = 'meuusuário';
    $DB["SENHA"] = 'minha senha';

String de conexão usada pelo Zabbix para estabelecer a conexão:

    DBUser/DBSenha@ORCL

[comment]: # ({/fe8fa72a-fe8fa72a})

[comment]: # ({new-b56155a3})
#### Known issues

To improve performance, you can convert the field types from *nclob* to *nvarchar2*, see [known issues](/manual/installation/known_issues#slow-configuration-sync-with-oracle).

[comment]: # ({/new-b56155a3})