CData Google Drive Drivers でアップロードするファイルの内容をストリームで指定する方法

CData Google Drive Drivers はGoogle Drive のAPI を通してドライブ上のファイルやフォルダ情報にアクセスできるドライバーです。また、ドライブにあるファイルをダウンロードしたり、ローカルのファイルをアップロードしたりすることができます。例えばファイルをアップロードする際は以下のようにUploadFile ストアドプロシージャを使い、アップロードするローカルファイルのパスを指定して実行します。

EXEC UploadFile @LocalFile = 'C:\test.txt'

UploadFile ストアドプロシージャは送信するファイル、アップロード先のフォルダやファイル名等をパラメータで指定してドライブにアップロードします。ドライバーのバージョン21 では、アップロードするファイルを指定する方法として、①LocalFile パラメータにファイルパスを指定する方法と、②FileContent パラメータにファイルのデータを指定する方法 の2種類がありました。バージョン22 では第3 の方法として、Content パラメータにストリームを指定する方法が追加されました。

Upload ストアドプロシージャでアップロードするファイルの指定方法

ストリームとはデータを扱う形態の一つで、特徴としてデータを分割しメモリ上にバッファリングさせながら入出力処理を行います。例えばUploadFile ストアドプロシージャで大きなファイルをアップロードするときに、LocalFile パラメータやFileContent パラメータによる方法ではファイル全体を一度にメモリに読み込んで送信していました。バージョン22 ではContent パラメータにファイルのインプットストリームオブジェクトを指定することで、メモリ領域を効率的に活用してファイルを送信することができます。Java などで実装する際には、FileInputStream で読み込んだファイルを一度書き出すことなく、そのままストアドプロシージャのパラメータに指定できます。

以下からは本機能の使用方法を説明します。

シナリオ

LocalFile パラメータを使用した例

従来の方法として、LocalFile パラメータでファイルを指定する例を示します。

CallableStatement cstmt = conn.prepareCall("UploadFile");
cstmt.setString("Name","test_uploaded.txt");
cstmt.setString("LocalFile","C:\\test.txt");
cstmt.execute();

Content パラメータを使用した例

これと同じ処理をContent パラメータを用いて実装した例を示します。

CallableStatement cstmt = conn.prepareCall("UploadFile");
cstmt.setString("Name","test_uploaded.txt");

// InputStreamを生成
InputStream file = new FileInputStream("C:\\test.txt");
cstmt.setBinaryStream("Content",file);
cstmt.execute();

C#での実装例

CData Google Drive ADO.NET Provider を用いてUploadFile ストアドプロシージャを実行する例を示します。

LocalFile パラメータを使用した例

こちらも従来の方法として、LocalFile パラメータでファイルを指定する例を示します。

GoogleDriveCommand cmd = new GoogleDriveCommand("UploadFile", connection);
cmd.CommandType = CommandType.StoredProcedure;
cmd.Parameters.Add(new GoogleDriveParameter("Name", "test_upload.txt"));
cmd.Parameters.Add(new GoogleDriveParameter("LocalFile", "C:\\test.txt"));
GoogleDriveDataReader rdr = cmd.ExecuteReader();

Content パラメータを使用した例

これと同じ処理をContent パラメータを用いて実装した例を示します。

GoogleDriveCommand cmd = new GoogleDriveCommand("UploadFile", connection);
cmd.CommandType = CommandType.StoredProcedure;
cmd.Parameters.Add(new GoogleDriveParameter("Name", "test_upload.txt"));

// InputStreamを生成
FileStream file = new FileStream("C:\\test.txt", FileMode.Open, FileAccess.Read);
cmd.Parameters.Add(new GoogleDriveParameter("Content", file));
GoogleDriveDataReader rdr = cmd.ExecuteReader();

おわりに

本記事ではCData Google Drive Drivers のファイルをアップロードするストアドプロシージャ(UploadFile ストアドプロシージャ)で、送信するファイルの内容としてストリームを指定する方法を説明しました。CData Google Drive Drivers は30日間無料でお使いいただけます。Google Drive との連携をご検討の方はぜひお試しください。

関連コンテンツ