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 Clientボタンをクリックして、新しいクライアントを作成します。
   
   図create-client.pngの説明
   
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クライアントを登録します。
   
   図new-client.pngの説明
   
8. 表示アイコンをクリックして、Client IDおよびClient Secretフィールドを表示します。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   
   
   図explicit.pngの説明
   

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

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

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

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

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

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

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

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

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

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

接続のエクスポート

1. 「接続の管理」ドロップダウン・メニューから「接続のエクスポート」をクリックして、選択した接続をエクスポートします。
2. エクスポートする接続を選択し、「エクスポート」をクリックします。
   
   図export.pngの説明
   
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スプレッドシートを使用した接続の作成」を参照してください。
   
   
   図adb-google-wizard.pngの説明
   
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.