Autonomous Databaseに接続するには、Database Actionsインスタンスから接続ファイルをダウンロードし、設定したGoogle Sheetアドオンにインポートします。

この項では、Web UIを使用してclient_idおよびclient_secretを取得します。

クライアント・キーを生成するには、oauth/clientsを付け足してAutonomous DatabaseインスタンスのURLにアクセスします。

たとえば、インスタンスが" https://<hostname>-<databasename>.adb.<region>.oraclecloudapps.com/ords/<schema Name>/_sdw/"の場合、リンク" https://<hostname>-<databasename>.adb.<region>.oraclecloudapps.com/ords/<schema Name>/oauth/clients/"にサインインする必要があります。必ず末尾のスラッシュを含めてください。

1. リンク"https://machinename.oraclecloudapps.com/ords/SchemaName/oauth/clients/"を使用してDatabase Actionsにサインインします。OAuthの「クライアント」ページは、リンク「https://localhost:port/ords/schemaName/_sdw/?nav=rest-workshop&rest-workshop=oauth-clients」で表示できます。
2. +Create OAuthクライアント・ボタンをクリックして、新しいクライアントを作成します。
   
   
   
3. 「権限タイプ」ドロップダウンから、必要なクライアント接続のタイプを選択します。次のオプションを選択できます。
   • AUTH_CODE: 暗黙接続の場合はこのオプションを選択します。このレスポンス・タイプは、自律型データベースがプライベート・サブネット内または顧客ファイアウォール内にある場合に使用します。
   • IMPLICIT: 明示的な接続の場合はこのオプションを選択します。これはより安全な方法であり、Autonomous Databaseにパブリック・アクセス権がある場合に使用することをお薦めします。
4. 次のフィールドに入力しますアスタリスク(*)の付いたフィールドは必須です。
   • Name: クライアントの名前。
   • 説明:クライアントの目的の説明。
   • リダイレクトURI: WebアプリケーションとしてのGoogleスクリプトのデプロイのステップ10からコピーしたWebアプリケーション・デプロイメントURL
   • サポートURI: エンド・ユーザーがサポートを得るためにクライアントに連絡できるURIを入力します。例: https://script.google.com/
   • サポート電子メール: エンド・ユーザーがサポートを得るためにクライアントに連絡できる電子メールを入力します。
   • ロゴ: オプションで、イメージを選択して新しいクライアントのロゴを挿入します。
   「ロール」タブに移動して、クライアントのロールを選択します。これは必須フィールドではありません。
5. 「許可されるオリジン」タブに進みます。テキスト・フィールドにURL接頭辞のリストを指定して追加します。これは必須フィールドではありません。
6. 「権限」タブに移動して、権限を追加します。OAuthクライアントを作成する権限は必要ありません。
7. 「作成」をクリックして、新しいOAuthクライアントを作成します。「OAuthクライアント」ページで表示できるOAuthクライアントが登録されます。
   
   
   
8. 表示アイコンをクリックして、Client IDおよびClient Secretフィールドを表示します。

手動で接続する方法を教えてください。

次の項では、暗黙的な接続および明示的な接続を使用して接続する方法を説明します。Google Sheetsでは、Autonomous Databaseにアクセスする権限が必要です。自律型データベースに接続するには、まず認可を完了する必要があります。このアドオンを設定するには1回かぎりの認証が必要です。

1. Google Sheetで「Oracle Autonomous Database」をクリックし、「接続」を選択します。
   接続を選択するには、1回かぎりのGoogle認証が必要です。

   • 「接続」をクリックすると、認可を実行する権限を求めるポップアップ・ウィンドウが開きます。「続行」をクリックします。
     
     
     
   • アプリケーションがGoogleアカウント内の機密情報へのアクセスをリクエストしていることを通知するウィンドウが表示されます。
   • 「詳細」をクリックし、「無題のプロジェクトに移動(安全でない)」リンクを選択します。リンクを選択すると新しいウィンドウが開き、アプリケーションを信頼していることを確認します。「Allow」をクリックして続行します。設定が完了しました。
2. 「接続」ウィザードで、「接続の管理」ドロップダウン・メニューから「接続の追加」をクリックして接続を追加します。
   
   
   
3. 「接続の追加」を選択すると、「接続」ウィザードの接続リスト・パネルに「接続の追加」ウィザードが開きます。
   
   
   

4. ウィザードで次のフィールド値を指定します。

   接続名: 接続の名前を入力します(たとえば、TestConnection)。

   Autonomous DatabaseのURL: 接続先のAutonomous DatabaseのURLを入力します。たとえば、"https://<hostname>-<databasename>.adb.<region>.oraclecloudapps.com/"です。

   「OAuthクライアントの権限付与タイプ」フィールドで、必要な接続のタイプに基づいて2つのオプションのいずれかを選択します。UIを使用したクライアントIDおよびクライアント・シークレットの生成に関する項を参照してください。

   このオプションは、暗黙的な接続と明示的な接続では異なります。

   暗黙的: 暗黙的な接続の場合はこのオプションを選択します。このレスポンス・タイプは、自律型データベースがプライベート・サブネット内または顧客ファイアウォール内にある場合に使用します。

   AUTH_CODE: 明示的な接続の場合はこのオプションを選択します。これはよりセキュアな方法であり、使用することをお薦めします。

   「暗黙的」オプションを選択すると、次のフィールドを表示できます。
   
   
   

   OAuthクライアントID: UIの「新規クライアントの作成」ウィザードを使用して生成するclient_idです。UIを使用したクライアントIDおよびクライアント・シークレットの生成に関する項を参照してください。

   スキーマ名: スキーマの名前を指定します。

   AUTH_CODEを選択すると、次のフィールドを表示できます。

   
   
   
   

   OAuthクライアントID: UIの「新規クライアントの作成」ウィザードを使用して生成するclient_idです。UIを使用したクライアントIDおよびクライアント・シークレットの生成に関する項を参照してください。

   OAuthクライアント・シークレット: UIの「新規クライアントの作成」ウィザードを使用して生成するclient_secretです。UIを使用したクライアントIDおよびクライアント・シークレットの生成に関する項を参照してください。

   スキーマ名: スキーマの名前を指定します。

   「保存」をクリックします。

   「保存」をクリックすると、接続リスト・パネルに新しい接続を表示できます。接続リストには、接続の名前、スキーマの名前および付与するOAuthタイプが表示されます。ただし、これはまだ切断された状態です。

5. 接続名の横にある、縦に並んだ3つのドットをクリックし、次の操作を実行します。

   接続: 「接続」でAutonomous Databaseを選択し、接続ステータスを「アクティブ」に変更します。「接続」を選択すると、Autonomous Databaseのサインイン・ページが開きます。ログインすると、データベース・アクセス権が付与されたことを示すページが表示されます。ウィンドウを閉じて、Google Sheetsに戻ります。これで、接続がアクティブになったことがわかります。

   編集: 「編集」を選択して、接続の値を更新します。「保存」をクリックして、編集した値を更新します。

   重複: 「重複」を選択して、重複する接続を作成します。

   削除: 「削除」を選択して、接続リストから接続を削除します。

接続のエクスポート

1. 「接続の管理」ドロップダウン・メニューから「接続のエクスポート」をクリックして、選択した接続をエクスポートします。
2. エクスポートする接続を選択し、「エクスポート」をクリックします。
   
   
   
3. 「エクスポート」をクリックします。

4. エクスポートされた接続がローカル・システムにダウンロードされます。接続ファイルはspreadsheet_addin_connections.jsonとして保存されます。

OAuth認証を使用してアイデンティティが特定されたら、Google SheetsにはAutonomous Databaseにアクセスする権限が必要です。

OAuth認証中に生成するclient_idおよびclient_secretの値は、認可に使用されます。

1. 作業中のGoogle SheetでOracle Autonomous Databaseメニューをクリックし、「登録」を選択します。これには、1回のGoogle認証が必要です。
2. 「登録」をクリックすると、認可を実行する権限を求めるポップアップ・ウィンドウが開きます。「続行」をクリックします。「続行」を選択すると、Googleアカウント・ページにリダイレクトされ、Gmailアカウントを選択する必要があります。
3. アプリケーションがGoogleアカウント内の機密情報へのアクセスをリクエストしていることを通知するウィンドウが表示されます。「Advanced」をクリックし、「Go to Untitled project (unsafe)」リンクを選択します。
4. リンクを選択すると、アプリケーションを信頼することを確認する新しいウィンドウが開きます。「Allow」をクリックして続行します。
5. 設定が完了しました。Google SheetのOracle Autonomous Databaseメニューから「登録」を選択します。
   Google Sheetで「Oracle Autonomous Database」ウィザードが開きます。次のフィールドを指定します。

   • ADB URL: ADB URLを入力します。たとえば、"https://<hostname>-<databasename>.adb.<region>.oraclecloudapps.com/ords/<Schema Name>"です。
   • OAuthクライアントID: 認証中に生成するclient_id。
   • OAuthクライアント・シークレット: 認証中に生成するclient_secret。詳細は、「Googleスプレッドシートを使用した接続の作成」を参照してください。
   
   
   
   
6. 「認可」を選択します。

After successfully authorizing the credentials, you can view Connections, Direct SQL, Data Analysis, Analyses and Reports Clear Sheet, Delete All Sheets, About Autonomous Database, and Sign Out menu items under Oracle Autonomous Database.

Oracle Autonomous Databaseアドオンfor Google Sheetsを使用すると、SQL問合せを実行してGoogle Sheetでデータを操作できます。アドオンを使用すると、SQLエディタ領域にSQLコードを入力し、「実行」をクリックしてコマンドを実行できます。

アドオンにより、結果がGoogle Sheetにロードされます。結果のロードにかかる時間は、レコード数と問合せの複雑さによって異なります。

レポートおよび分析ビューを表示したり、分析のためにデータを視覚化できます。

レポートおよびチャートは、様々なチャート(棒グラフ、面グラフ、線グラフおよび円グラフ)で表示できます。レポートは、分析ビューから作成する分析インサイトを提供します。分析には複数のレポートを含めることができます。「分析とレポート」アイコンを使用すると、Autonomous Databaseから分析とレポートを取得できます。

アドオンによって問合せが実行され、データがワークシートに取得されたら、自動生成された問合せ結果の分析ビューのタイムスタンプ、ユーザー、AV問合せおよびSQL問合せを表示できます。

アドオンによって問合せが実行され、データがワークシートに取得されたら、自動生成された問合せ結果の分析ビューのタイムスタンプ、ユーザー、AV問合せおよびSQL問合せを表示できます。

ワークシートには、問合せの結果が一度に表示されます。たとえば、問合せを変更し、同じシートで問合せ結果を生成する場合を考えてみます。シートの既存のデータをクリアする必要があります。

Google Sheetで問合せ結果をクリアするには、メニュー項目「Oracle Autonomous Database」をクリックし、「シートのクリア」を選択します。

このオプションにより、イメージや書式設定など、選択したシートのすべてのデータ型が消去されます。

このオプションを使用して、スプレッドシートに存在するすべてのシートを削除します。

Oracle Autonomous Databaseメニューから「すべてのシートの削除」を選択して、スプレッドシートからすべてのシートを削除します。

このオプションを使用して、アドインの詳細を表示します

「Oracle Autonomous Databaseについて」メニューの「Oracle Autonomous Database」には、アドオンがサーバーに接続されているかどうか、ORDSバージョン、アドイン・バージョン、ORDSスキーマ・バージョン、データベースのメジャーおよびマイナー・バージョン、ADB URLおよびスキーマが表示されます。

問合せ結果をGoogle Sheetで生成すると、他のユーザーと共有できます。共有では、ワークシートのコピーを作成し、設計ツールを非表示にしてワークシート保護をオンの状態で送信します。