[comment]: # translation:outdated

[comment]: # ({710cea74-710cea74})
# 12 Oracle-database instellen

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

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

Dit gedeelte bevat instructies voor het maken van een Oracle-database en:
verbindingen configureren tussen de database en Zabbix-server, proxy,
en front-end.

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

[comment]: # ({25ccb612-2fd36a67})
### Database creatie

We gaan ervan uit dat een *zabbix* databasegebruiker met *wachtwoord* wachtwoord bestaat en toestemming heeft om databaseobjecten te maken in de ORCL-service op de *host* Oracle-databaseserver. Zabbix vereist een Unicode-databasekarakterset en een `UTF8` nationale karakterset. Controleer de huidige instellingen:

    sqlplus> select parameter,value from v$nls_parameters where parameter='NLS_CHARACTERSET' or parameter='NLS_NCHAR_CHARACTERSET';

Bereid nu de database voor:

    cd /pad/naar/zabbix-bronnen/database/oracle
    sqlplus zabbix/wachtwoord@oracle_host/ORCL
    sqlplus> @schema.sql
    # stop hier als je een database voor Zabbix-proxy aanmaakt
    sqlplus> @images.sql
    sqlplus> @data.sql

::: notitietip
Stel de initialisatieparameter CURSOR\_SHARING=FORCE in voor de beste prestaties.
:::

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

[comment]: # ({db4ecc98-db4ecc98})
### Verbinding tot stand gebracht

Zabbix ondersteunt twee soorten verbindings-ID's (verbindingsmethoden):

- Eenvoudig verbinden
- Netservicenaam

Verbindingsconfiguratieparameters voor Zabbix-server en Zabbix-proxy
kan worden ingesteld in de configuratiebestanden. Belangrijke parameters voor de
server en proxy zijn *DBHost*, *DBUser*, *DBName* en *DBPassword*. De
dezelfde parameters zijn belangrijk voor de frontend: *$DB\["SERVER"\]*,
*$DB\["POORT"\]*, *$DB\["DATABASE"\]*, *$DB\["USER"\]*,
*$DB\["WACHTWOORD"\]*.

Zabbix gebruikt de volgende syntaxis van de verbindingsreeks:

    {DBUser/DBPassword[@<connect_identifier>]}

<connect\_identifier> kan worden opgegeven in de vorm van "Net
Servicenaam" of "Easy Connect".

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

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

[comment]: # ({ed80a373-ed80a373})
#### Eenvoudig verbinden

Easy Connect gebruikt de volgende parameters om verbinding te maken met de database:

- *Host* - de hostnaam of het IP-adres van de databaseservercomputer
    (DBHost-parameter in het configuratiebestand).
- *Poort* - de luisterpoort op de databaseserver (DBPort-parameter
    in het configuratiebestand; indien niet ingesteld, zal de standaard 1521-poort zijn:
    gebruikt).
- <service\_name> - de servicenaam van de database die u wilt
    access (DBName-parameter in het configuratiebestand).

**Voorbeeld:**

Databaseparameters ingesteld in het server- of proxyconfiguratiebestand
(zabbix\_server.conf en zabbix\_proxy.conf):

    DBHost=lokale host
    DBPort=1521
    DBUser=mijngebruikersnaam
    DBName=ORCL
    DBPassword=mijnwachtwoord

Verbindingsreeks gebruikt door Zabbix om verbinding tot stand te brengen:

    DBUser/DBPassword@DBHost:DBPort/DBName

Stel tijdens Zabbix frontend-installatie de bijbehorende parameters in
de stap *DB-verbinding configureren* van de installatiewizard:

- Databasehost: localhost
- Databasepoort: 1521
- Databasenaam: ORCL
- Gebruiker: mijngebruikersnaam
- Wachtwoord: mijnwachtwoord

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

Als alternatief kunnen deze parameters worden ingesteld in de frontend-configuratie
bestand (zabbix.conf.php):

    $DB["TYPE"] = 'ORAKLE';
    $DB["SERVER"] = 'localhost';
    $DB["POORT"] = '1521';
    $DB["DATABASE"] = 'ORCL';
    $DB["USER"] = 'mijngebruikersnaam';
    $DB["PASSWORD"] = 'mijnwachtwoord';

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

[comment]: # ({9f0ccdfd-fe8fa72a})
#### Net service naam

Sinds Zabbix 5.4.0 is het mogelijk om verbinding te maken met Oracle door gebruik te maken van een net service naam.

<net\_service\_name> is een eenvoudige naam voor een service die oplost naar een connect descriptor.

Om de service naam te gebruiken voor het maken van een verbinding, moet deze service naam worden gedefinieerd in het tnsnames.ora-bestand dat zich zowel op de databaseserver als op de clientsystemen bevindt. De eenvoudigste manier om ervoor te zorgen dat de verbinding slaagt, is door de locatie van het tnsnames.ora-bestand te definiëren in de TNS\_ADMIN omgevingsvariabele. De standaardlocatie van het tnsnames.ora-bestand is:

    $ORACLE_HOME/network/admin/

Een eenvoudig voorbeeld van een tnsnames.ora-bestand:

    ORCL =
      (DESCRIPTION =
        (ADDRESS = (PROTOCOL = TCP)(HOST = localhost)(PORT = 1521))
        (CONNECT_DATA =
          (SERVER = DEDICATED)
          (SERVICE_NAME = ORCL)
        )
      )

Om configuratieparameters in te stellen voor de "Net Service Name" verbindingsmethode, gebruik een van de volgende opties:

-   Stel een lege parameter DBHost in en stel DBName in zoals gewoonlijk:

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

-   Stel beide parameters in en laat beide leeg:

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

In het tweede geval moet de TWO\_TASK omgevingsvariabele worden ingesteld. Het specificeert de standaard externe Oracle-service (service naam). Wanneer deze variabele is gedefinieerd, maakt de connector verbinding met de gespecificeerde database door gebruik te maken van een Oracle-listener die verbindingsverzoeken accepteert. Deze variabele is alleen voor gebruik op Linux en UNIX. Gebruik de LOCAL omgevingsvariabele voor Microsoft Windows.

**Voorbeeld:**

Maak verbinding met een database met behulp van de Net Service Name ingesteld als ORCL en de standaard poort. Databaseparameters ingesteld in het configuratiebestand van de server of proxy (zabbix\_server.conf en zabbix\_proxy.conf):

    DBHost=
    #DBPort=
    DBUser=myusername
    DBName=ORCL
    DBPassword=mypassword

Tijdens de installatie van de Zabbix frontend stel je de overeenkomstige parameters in bij de *Configure DB connection* stap van de installatiewizard:

-   Databasehost:
-   Databasepoort: 0
-   Databasenaam: ORCL
-   Gebruiker: myusername
-   Wachtwoord: mypassword

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

Als alternatief kunnen deze parameters worden ingesteld in het frontend configuratiebestand (zabbix.conf.php):

    $DB["TYPE"]                     = 'ORACLE';
    $DB["SERVER"]                   = '';
    $DB["PORT"]           = '0';
    $DB["DATABASE"]                 = 'ORCL';
    $DB["USER"]                     = 'myusername';
    $DB["PASSWORD"]                 = 'mypassword';

Verbindingsreeks die door Zabbix wordt gebruikt om verbinding te maken:

    DBUser/DBPassword@ORCL

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

[comment]: # ({74be0d8b-b56155a3})
#### Bekende problemen

Om de prestaties te verbeteren, kunt u de veldtypen converteren van *nclob* naar *nvarchar2*, zie [bekende problemen](/manual/installation/known_issues#slow-configuration-sync-with-oracle).

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