Apps Script は、標準の Java Database Connectivity テクノロジーのラッパーである JDBC サービスを介して外部データベースに接続できます。JDBC サービスは、Google Cloud SQL for MySQL、MySQL、Microsoft SQL Server、Oracle データベースをサポートしています。
JDBC を使用して外部データベースを更新するには、スクリプトでデータベースへの接続を開き、SQL ステートメントを送信して変更を行う必要があります。
Google Cloud SQL データベース
Google Cloud SQL を使用すると、Google のクラウドに存在するリレーショナル データベースを作成できます。Cloud SQL では、使用量に基づいて料金が発生する場合があります。
Cloud SQL クイックスタートに記載されている手順に沿って、Google Cloud SQL インスタンスを作成できます。
Google Cloud SQL 接続の作成
Apps Script の JDBC サービスを使用して Google Cloud SQL データベースとの接続を確立するには、次の 2 つの方法があります。
- (推奨)Jdbc.getCloudSqlConnection(url) を使用して接続する
- Jdbc.getConnection(url) を使用して接続する
これらの方法については、以下で説明します。どちらも有効ですが、2 番目の方法では、データベースへのアクセス用に IP 範囲のセットを承認する必要があります。
Jdbc.getCloudSqlConnection(url) を使用する(推奨)
このメソッドは、Jdbc.getCloudSqlConnection(url) メソッドを使用して Google Cloud SQL MySQL インスタンスへの接続を作成します。データベース URL の形式は jdbc:google:mysql://subname
です。ここで、subname
は Google Cloud コンソールの Cloud SQL インスタンスの [概要] ページに表示される MySQL のインスタンス接続名です。
Cloud SQL SQL Server に接続するには、Jdbc.getConnection(url) をご覧ください。
Jdbc.getConnection(url) を使用する
この方法を使用するには、Apps Script のサーバーがデータベースに接続できるように、特定のクラスレス ドメイン間ルーティング(CIDR)IP アドレス範囲を承認する必要があります。スクリプトを実行する前に、次の手順を完了します。
データベースに割り当てられた URL をコピーします。URL は
jdbc:mysql:subname
の形式になります。
これらの IP 範囲を承認したら、上記の Jdbc.getConnection(url) メソッドのいずれかと、コピーした URL を使用して、Google Cloud SQL インスタンスへの接続を作成できます。
その他のデータベース
MySQL、Microsoft SQL Server、Oracle データベースをすでに所有している場合は、Apps Script の JDBC サービスを使用して接続できます。
その他のデータベース接続の作成
Apps Script の JDBC サービスを使用してデータベース接続を作成するには、データベース設定でこのデータソースの IP 範囲を承認する必要があります。
これらの許可リストが設定されたら、Jdbc.getConnection(url) メソッドとデータベースの URL を使用して、データベースへの接続を作成できます。
サンプルコード
次のサンプルコードは、Google Cloud SQL データベースに接続することを前提としており、Jdbc.getCloudSqlConnection(url) メソッドを使用してデータベース接続を作成します。他のデータベースの場合は、Jdbc.getConnection(url) メソッドを使用してデータベース接続を作成する必要があります。
JDBC メソッドの詳細については、JDBC の Java ドキュメントをご覧ください。
データベース、ユーザー、テーブルを作成する
ほとんどのデベロッパーは、MySQL コマンドライン ツールを使用して、データベース、ユーザー、テーブルを作成します。ただし、以下に示すように、Apps Script で同じことを行うことは可能です。スクリプトが常に root
としてデータベースに接続する必要がないように、少なくとも 1 人のユーザーを作成することをおすすめします。
データベースに書き込む
次の例は、単一のレコードと 500 件のレコードのバッチをデータベースに書き込む方法を示しています。バッチ処理は一括オペレーションに不可欠です。
また、パラメータ化されたステートメントも使用されています。このステートメントでは、変数は ?
で示されます。SQL インジェクション攻撃を防ぐには、パラメータ化されたステートメントを使用して、ユーザーが提供したすべてのデータをエスケープする必要があります。
データベースから読み取る
この例では、データベースから多数のレコードを読み取り、必要に応じて結果セットをループ処理する方法を示します。
接続を閉じる
スクリプトの実行が終了すると、JDBC 接続は自動的に閉じます。(呼び出しを行った HTML サービスページが開いたままでも、1 回の google.script.run
呼び出しは 1 回の実行としてカウントされます)。
ただし、スクリプトの終了前に接続、ステートメント、結果セットが完了することがわかっている場合は、JdbcConnection.close()
、JdbcStatement.close()
、または JdbcResultSet.close()
を呼び出して手動で閉じることをおすすめします。
アラートまたはプロンプト ダイアログを表示すると、開いている JDBC 接続も終了します。ただし、カスタム メニューやダイアログ、カスタム コンテンツを含むサイドバーなど、他の UI 要素の表示は、このポリシーの対象外です。
Google、Google Workspace、および関連するマークとロゴは、Google LLC の商標です。その他すべての企業名および商品名は関連各社の商標です。