JDBC

Apps Script può connettersi a database esterni tramite Servizio JDBC, un wrapper attorno al modello Tecnologia Java Database Connectivity. Il servizio JDBC supporta Google Cloud SQL per MySQL, MySQL, Microsoft SQL Server e Oracle.

Per aggiornare un database esterno con JDBC, lo script deve aprire una connessione al database e apportarvi modifiche inviando istruzioni SQL.

Database Google Cloud SQL

Google Cloud SQL ti consente di creare database relazionali che risiedono nel cloud di Google. Tieni presente che Cloud SQL potrebbero comportare costi in base all'utilizzo.

Puoi creare un'istanza Google Cloud SQL seguendo i passaggi elencati in Guida rapida di Cloud SQL.

Creazione di connessioni Google Cloud SQL

Ci sono due modi per stabilire una connessione con un database Google Cloud SQL utilizzando il servizio JDBC di Apps Script:

Questi metodi sono descritti di seguito. Entrambi sono validi, ma il secondo metodo richiede l'autorizzazione di un insieme di intervalli IP per l'accesso al database.

Questo metodo crea una connessione a un'istanza MySQL di Google Cloud SQL utilizzando Jdbc.getCloudSqlConnection(url) . L'URL del database ha il formato jdbc:google:mysql://subname, dove subname è il Nome connessione istanza di MySQL elencato nella pagina Panoramica dell'istanza Cloud SQL nella Console Google Cloud.

Per connetterti a Cloud SQL SQL Server, vedi Jdbc.getConnection(url).

Utilizzo di Jdbc.getConnection(url)

Per utilizzare questo metodo, devi autorizzare determinate Routing senza classe tra domini (CIDR) Intervalli di indirizzi IP in modo che i server di Apps Script possano connettersi al tuo database. Prima di eseguire lo script, completa i seguenti passaggi:

  1. Nella tua istanza Google Cloud SQL, autorizzare gli intervalli IP, uno alla volta da questa origine dati.

  2. Copia l'URL assegnato al tuo database. dovrebbe avere modulo jdbc:mysql:subname.

Dopo aver autorizzato questi intervalli IP, puoi creare connessioni al tuo l'istanza Google Cloud SQL utilizzando uno dei Jdbc.getConnection(url) e l'URL che hai copiato in precedenza.

Altri database

Se hai già un database MySQL, Microsoft SQL Server o Oracle, puoi connetterti tramite il servizio JDBC di Apps Script.

Creazione di altre connessioni di database

Per creare una connessione a un database utilizzando Apps Script Servizio JDBC, nelle impostazioni del database devi autorizzare gli intervalli IP da questa origine dati.

Dopo aver creato queste liste consentite, puoi creare una connessione al database utilizzando uno dei Jdbc.getConnection(url) e l'URL del database.

Codice di esempio

Il codice campione seguente presuppone che ti stia connettendo a un database Google Cloud SQL. e crea connessioni al database utilizzando Jdbc.getCloudSqlConnection(url) . Per altri database devi usare la classe Jdbc.getConnection(url) per creare le connessioni ai database.

Per ulteriori informazioni sui metodi JDBC, consulta Documentazione Java per JDBC.

Crea un database, un utente e una tabella

La maggior parte degli sviluppatori utilizza strumento a riga di comando MySQL per creare database, utenti e tabelle. Tuttavia, puoi fare lo stesso in Apps Script, come mostrato di seguito. Conviene crearne almeno uno a un altro utente, così non sempre lo script deve connettersi al database root.

service/jdbc.gs
/**
 * Create a new database within a Cloud SQL instance.
 */
function createDatabase() {
  try {
    const conn = Jdbc.getCloudSqlConnection(instanceUrl, root, rootPwd);
    conn.createStatement().execute('CREATE DATABASE ' + db);
  } catch (err) {
    // TODO(developer) - Handle exception from the API
    console.log('Failed with an error %s', err.message);
  }
}

/**
 * Create a new user for your database with full privileges.
 */
function createUser() {
  try {
    const conn = Jdbc.getCloudSqlConnection(dbUrl, root, rootPwd);

    const stmt = conn.prepareStatement('CREATE USER ? IDENTIFIED BY ?');
    stmt.setString(1, user);
    stmt.setString(2, userPwd);
    stmt.execute();

    conn.createStatement().execute('GRANT ALL ON `%`.* TO ' + user);
  } catch (err) {
    // TODO(developer) - Handle exception from the API
    console.log('Failed with an error %s', err.message);
  }
}

/**
 * Create a new table in the database.
 */
function createTable() {
  try {
    const conn = Jdbc.getCloudSqlConnection(dbUrl, user, userPwd);
    conn.createStatement().execute('CREATE TABLE entries ' +
      '(guestName VARCHAR(255), content VARCHAR(255), ' +
      'entryID INT NOT NULL AUTO_INCREMENT, PRIMARY KEY(entryID));');
  } catch (err) {
    // TODO(developer) - Handle exception from the API
    console.log('Failed with an error %s', err.message);
  }
}

Scrivi nel database

I seguenti esempi mostrano come scrivere un singolo record nel database come e un batch di 500 record. Il raggruppamento in batch è fondamentale per le operazioni collettive.

Si noti anche l'uso di istruzioni con parametri, in cui le variabili vengono indicato con ?. Per evitare attacchi di SQL injection, è consigliabile utilizzare istruzioni con parametri per eseguire l'escape di tutti i dati forniti dall'utente.

service/jdbc.gs
/**
 * Write one row of data to a table.
 */
function writeOneRecord() {
  try {
    const conn = Jdbc.getCloudSqlConnection(dbUrl, user, userPwd);

    const stmt = conn.prepareStatement('INSERT INTO entries ' +
      '(guestName, content) values (?, ?)');
    stmt.setString(1, 'First Guest');
    stmt.setString(2, 'Hello, world');
    stmt.execute();
  } catch (err) {
    // TODO(developer) - Handle exception from the API
    console.log('Failed with an error %s', err.message);
  }
}

/**
 * Write 500 rows of data to a table in a single batch.
 */
function writeManyRecords() {
  try {
    const conn = Jdbc.getCloudSqlConnection(dbUrl, user, userPwd);
    conn.setAutoCommit(false);

    const start = new Date();
    const stmt = conn.prepareStatement('INSERT INTO entries ' +
      '(guestName, content) values (?, ?)');
    for (let i = 0; i < 500; i++) {
      stmt.setString(1, 'Name ' + i);
      stmt.setString(2, 'Hello, world ' + i);
      stmt.addBatch();
    }

    const batch = stmt.executeBatch();
    conn.commit();
    conn.close();

    const end = new Date();
    console.log('Time elapsed: %sms for %s rows.', end - start, batch.length);
  } catch (err) {
    // TODO(developer) - Handle exception from the API
    console.log('Failed with an error %s', err.message);
  }
}

Leggi dal database

Questo esempio mostra come leggere un numero elevato di record dal eseguendo il loop sul set di risultati in base alle esigenze.

service/jdbc.gs
/**
 * Read up to 1000 rows of data from the table and log them.
 */
function readFromTable() {
  try {
    const conn = Jdbc.getCloudSqlConnection(dbUrl, user, userPwd);
    const start = new Date();
    const stmt = conn.createStatement();
    stmt.setMaxRows(1000);
    const results = stmt.executeQuery('SELECT * FROM entries');
    const numCols = results.getMetaData().getColumnCount();

    while (results.next()) {
      let rowString = '';
      for (let col = 0; col < numCols; col++) {
        rowString += results.getString(col + 1) + '\t';
      }
      console.log(rowString);
    }

    results.close();
    stmt.close();

    const end = new Date();
    console.log('Time elapsed: %sms', end - start);
  } catch (err) {
    // TODO(developer) - Handle exception from the API
    console.log('Failed with an error %s', err.message);
  }
}

Chiusura delle connessioni in corso...

Le connessioni JDBC si chiudono automaticamente al termine dell'esecuzione di uno script. (Mantieni dentro tieni presente che una singola google.script.run viene conteggiata un'esecuzione completa, anche se la pagina del servizio HTML che ha effettuato rimane aperta.)

Tuttavia, se sai di aver terminato con una connessione, un'istruzione o un set di risultati, prima della fine dello script, è una buona idea chiuderli manualmente chiamando JdbcConnection.close(), JdbcStatement.close(), o JdbcResultSet.close()

Visualizzazione di una finestra di dialogo di avviso o richiesta termina anche tutte le connessioni JDBC aperte. Tuttavia, anche altri elementi dell'interfaccia utente come menu o finestre di dialogo e barre laterali personalizzati con contenuti, non lo fa.

Google, Google Workspace e i rispettivi marchi e loghi sono marchi di Google LLC Tutti gli altri nomi di società e prodotti sono marchi delle società a cui sono associati.