Come collegare il tuo DB su CIBYL

Il primo passo per iniziare a lavorare con i tuoi dati in CIBYL è stabilire una connessione con il tuo database.

Connessione Diretta

Per connettere il tuo database, puoi utilizzare una stringa di connessione, che definisce come stabilire una connessione con il server del database.

Cos’è una Stringa di Connessione?

Una stringa di connessione è una stringa basata su testo che contiene i parametri necessari per consentire a un’applicazione di connettersi a un database. Funziona come una ricetta, includendo tutti gli elementi necessari per stabilire una connessione corretta.

Elementi Chiave di una Stringa di Connessione

1. Data Source/Server
   • Descrizione: Specifica il nome o l’indirizzo di rete del server del database.
   • Esempio: Server=myServerAddress; o Data Source=myServerAddress;
2. Initial Catalog/Database
   • Descrizione: Indica il nome del database specifico a cui connettersi.
   • Esempio: Database=myDataBase; o Initial Catalog=myDataBase;
3. User ID/UID
   • Descrizione: Il nome utente utilizzato per l’autenticazione al database.
   • Esempio: User ID=myUsername; o UID=myUsername;
4. Password/PWD
   • Descrizione: La password associata all’ID utente corrispondente.
   • Esempio: Password=myPassword; o PWD=myPassword;
5. Integrated Security/Trusted Connection
   • Descrizione: Specifica se utilizzare l’autenticazione di Windows.
   • Esempio: Integrated Security=True; o Trusted_Connection=True;
6. Porta
   • Descrizione: (Opzionale) Il numero di porta del server del database, spesso richiesto per connessioni remote.
   • Esempio: Port=1433;
7. Provider
   • Descrizione: Specifica il provider di dati utilizzato per la connessione.
   • Esempio: Provider=SQLOLEDB;
8. Timeout
   • Descrizione: Imposta il tempo massimo (in secondi) per tentare di stabilire una connessione prima dell’interruzione.
   • Esempio: Connection Timeout=30;
9. Crittografia
   • Descrizione: Specifica se la connessione deve essere crittografata.
   • Esempio: Encrypt=True;

Esempio di Stringa di Connessione

Ecco un esempio di stringa di connessione:

Server=myServerAddress;Database=myDataBase;User ID=myUsername;Password=myPassword;Trusted_Connection=False;Encrypt=True;Connection Timeout=30;

• Server=myServerAddress;: Specifica l’indirizzo del server.
• Database=myDataBase;: Definisce il database a cui connettersi.
• User ID=myUsername;: Il nome utente per l’autenticazione.
• Password=myPassword;: La password associata all’utente.
• Trusted_Connection=False;: Viene utilizzata l’autenticazione di SQL Server.
• Encrypt=True;: Garantisce la crittografia della connessione.
• Connection Timeout=30;: Il sistema tenterà di connettersi per 30 secondi prima di interrompere il tentativo.

La corretta configurazione della stringa di connessione garantisce una connettività sicura e affidabile al database.

Stringhe di Connessione URI

In molti casi, viene utilizzata una Stringa di Connessione URI per le connessioni al database. Una URI (Uniform Resource Identifier) segue un formato standardizzato, spesso utilizzato per database come MongoDB, PostgreSQL e altri.

Elementi Chiave di una Stringa di Connessione URI

1. Schema
   • Descrizione: Specifica il protocollo o il driver del database.
   • Esempio: mongodb://, postgresql://
2. Nome Utente
   • Descrizione: Il nome utente per l’autenticazione.
   • Esempio: user
3. Password
   • Descrizione: La password per il nome utente.
   • Esempio: password
4. Host
   • Descrizione: Il nome host o l’indirizzo IP del server del database.
   • Esempio: host1
5. Porta
   • Descrizione: (Opzionale) Il numero di porta del server del database.
   • Esempio: 27017 per MongoDB, 5432 per PostgreSQL
6. Database
   • Descrizione: Specifica il database a cui connettersi.
   • Esempio: myDatabase
7. Opzioni
   • Descrizione: (Opzionale) Parametri aggiuntivi di connessione.
   • Esempio: ?ssl=true&replicaSet=myReplicaSet

Esempi di Stringhe di Connessione URI

Esempio URI MongoDB:

mongodb://user:password@host1:27017,host2:27017/myDatabase?replicaSet=myReplicaSet&ssl=true

Esempio URI PostgreSQL:

postgresql://user:password@host1:5432/myDatabase?sslmode=require

Riassunto dell’Esempio MongoDB:

• mongodb://: Specifica il driver MongoDB.
• user:password@: Nome utente e password per l’autenticazione.
• host1:27017,host2:27017: Nomi host e porte delle istanze MongoDB.
• /myDatabase: Specifica il database di destinazione.
• ?replicaSet=myReplicaSet&ssl=true: Opzioni aggiuntive, come l’abilitazione di SSL.

Formato Generale per Stringhe di Connessione URI

Il formato generale di una stringa di connessione URI è il seguente:

schema://user:password@host:port/database?options

Esempi di Stringhe di Connessione URI per Database Popolari

1. MySQL

   mysql://root:myPassword@localhost:3306/myDatabase?charset=utf8mb4

2. PostgreSQL

   postgresql://user:password@localhost:5432/myDatabase?sslmode=require

3. SQL Server

   sqlserver://sa:myPassword@localhost:1433/myDatabase?encrypt=true&trustServerCertificate=false

4. SQLite

   sqlite:///C:/sqlite/db/myDatabase.db?mode=ro

5. Oracle

   oracle://user:password@localhost:1521/myServiceName?encoding=UTF-8

6. Redis

   redis://default:myPassword@localhost:6379?ssl=true

Questi esempi fungono da modelli per creare stringhe di connessione URI per diversi database. Regola i parametri in base al tuo ambiente e ai tuoi requisiti.

Comprendere come configurare correttamente sia le stringhe di connessione tradizionali che quelle URI garantisce che le tue applicazioni possano accedere in modo efficiente e sicuro ai dati necessari in CIBYL.