機械翻訳について

Oracle Autonomous Database for Google Sheets

Oracle Autonomous Databaseアドオンこのイメージは、Oracle Autonomous Database for Google Sheetsアドオンを示しています。では、Google Sheetsから直接ウィザードを使用してSQLビューまたはアナリティク・ビューを使用して表を問い合せてアナリティクできます。

Autonomous Databaseから取得したデータは、さらに分析するためにGoogle Sheetsでローカルで使用できます。 結果はローカル・コピーに格納され、Autonomous Databaseに書き戻すことはできません。 直接SQL問合せを実行したり、分析ビューを問い合せたり、ワークシートに結果を表示できます。 このアドオンを使用すると、問合せ結果をフィルタし、表の結合および計算を実行できます。

ノート:

Google Sheets用のOracle Autonomous Databaseアドオンは、「プライバシ・ポリシー」に準拠している必要があります。 プライバシ・ポリシーの詳細については、「Oracle Autonomous Database for Google Sheetsプライバシ・ポリシー詳細」を参照してください。

Google Sheets用アドオンの動作

Autonomous Databaseから分析ビューまたはアナリティク表を問い合せるには、操作する分析ビューまたはアナリティク表を選択する必要があります。 分析ビューからデータを取得する際に、要件に従って問合せを構成できます。 特定の階層を選択し、ウィザードでカスタム計算を作成できます。 アドオンによって問合せが構成され、結果がGoogle Sheetsに返されます。 問合せの結果は、Google Sheetにローカルに保存できます。 また、アドオンは、アクセス権のあるスキーマに直接問い合せることもできます。 Web UIを使用して、Data Studioツールの「データ分析」メニューで作成したレポートおよび分析を表示することもできます。

このアドオンを使用するには、Autonomous DatabaseアカウントでWebアクセスを有効にする必要があります。 Google Sheetsアドオンにアクセスするには、SQLワークシートにCONNECT、DWROLE、RESOURCEおよびADPUSERロールが付与されている必要があります。

ノート:

  • 「ダウンロードMicrosoft Excel/Googleスプレッドシート・アド・イン」は、ADPUSERロールを持っている場合にのみ、データベース・アクション・インスタンスの「ダウンロード」メニューで使用できます。
  • Google Sheets用Oracle Autonomous Databaseアドオンは、Safari webブラウザではサポートされていません。

親トピック: データ分析ツール

接続ファイルのダウンロード

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

次に示すステップに従って、接続ファイルをダウンロードします。
  1. Database Actionsインスタンスの起動パッドに移動し、「Microsoft Excel/Google Sheetsアドインのダウンロード」カードを選択します。 「ダウンロード」ページの「Googleスプレッドシート」タブの「接続ファイルのダウンロード」ボタンをクリックして、接続ファイルをGoogleアドインにインポートします。

  2. この接続ファイルを使用すると、ログイン・ユーザーでAutonomous Databaseに接続できます。 これらの接続ファイルは、現在のAutonomous DatabaseインスタンスからダウンロードしたGoogleアドインにのみインポートできます。
    download-connection-file.pngの説明は以下のとおりです
    図download-connection-file.pngの説明

  3. 「接続ファイルのダウンロード」ボタンを選択すると、「接続ファイルのダウンロード」ウィザードが開きます。 ウィザードで次のフィールド値を指定します。
    • Googleスプレッドシート・リダイレクトURL: これは、「WebアプリケーションとしてのGoogleスクリプトのデプロイ」セクションのステップ番号9からコピーしたWebアプリケーション・デプロイメントURLです。
    • 「レスポンス・タイプ」を選択します:
      • 明示的接続

        Autonomous Databaseを使用するためにGoogle Sheetsを認証および認可するには、OAuthクライアントIDおよびOAuthクライアント・シークレットの値を使用します。 「データベース・アクション」ページから接続ファイルをダウンロードする際に、CODEをレスポンス・タイプとして使用する場合に使用します。 これはよりセキュアな方法であるため、自律型データベースにパブリック・アクセスがある場合に使用することをお薦めします。

      • 暗黙的接続

        Autonomous Databaseに暗黙的にアクセスするには、OAuthクライアントIDが必要です。 Database Actionsページから接続ファイルをダウンロードする際に、「トークン」を「レスポンス・タイプ」として使用する場合に使用します。 これは、自律型データベースがプライベート・サブネットまたは顧客ファイアウォール内にある場合に使用します。

親トピック: Oracle Autonomous Database for Google Sheets

UIを使用したクライアントIDとクライアント・シークレットの生成

この項では、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. 「+OAuthクライアントの作成」ボタンをクリックして、新しいクライアントを作成します。
    create-client.pngの説明は以下のとおりです
    図create-client.pngの説明
  3. 「付与タイプ」ドロップダウンから、必要なクライアント接続のタイプを選択します。 次のオプションを選択できます:
    • AUTH_CODE: 暗黙的な接続の場合は、このオプションを選択します。 このレスポンス・タイプは、自律型データベースがプライベート・サブネット内または顧客ファイアウォール内にある場合に使用します。
    • IMPLICIT: 明示的な接続の場合は、このオプションを選択します。 これはよりセキュアな方法であるため、自律型データベースにパブリック・アクセスがある場合に使用することをお薦めします。
  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の説明は以下のとおりです
    図new-client.pngの説明
  8. 「表示」アイコンをクリックして、Client IDフィールドとClient Secretフィールドを表示します。

手動で接続する方法

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

  1. Googleシートで、Oracle Autonomous Databaseをクリックし、「接続」を選択します。
    接続を選択するには、1回かぎりのGoogle認証が必要です。
    • 「登録」をクリックすると、認可を実行する権限を求めるポップアップ・ウィンドウが開きます。 「続行」をクリックします。
      auth-continue.pngの説明が続きます
      図auth-continue.pngの説明
    • アプリケーションがGoogleアカウント内の機密情報へのアクセスをリクエストしていることを通知するウィンドウが表示されます。
    • 「Advanced」をクリックし、「Go to Untitled project (unsafe)」リンクを選択します。 リンクを選択すると、アプリケーションを信頼することを確認する新しいウィンドウが開きます。 「Allow」をクリックして続行します。 これで、設定が完了しました。
  2. 接続ウィザードで、「接続の管理」ドロップダウン・メニューから「接続の追加」をクリックして接続を追加します。
    add-connection.pngの説明が続きます
    「図add-connection.pngの説明」
  3. 「接続の追加」を選択すると、「接続」ウィザードの接続リスト・パネルに「接続の追加」ウィザードが開きます。
    add-connection-fields.pngの説明が続きます
    図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の説明が続きます
    図implicit.pngの説明

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

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

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


    explicit.pngの説明が続きます
    図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の説明は以下のとおりです
    図export.pngの説明
  3. 「エクスポート」をクリックします。

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

親トピック: Oracle Autonomous Database for Google Sheets

Autonomous Databaseを使用するためのGoogleシートの承認

OAuth認証を使用してアイデンティティを決定した後、Google SheetsはAutonomous Databaseにアクセスする権限を必要とします。

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

  1. 作業中のGoogleシートのOracle Autonomous Databaseメニューをクリックし、「登録」を選択します。 これには、1回かぎりのGoogle認証が必要です。
  2. 「登録」をクリックすると、認可を実行する権限を求めるポップアップ・ウィンドウが開きます。 「続行」をクリックします。 「続行」を選択すると、Gmailアカウントを選択する必要があるGoogleアカウント・ページにリダイレクトされます。
  3. アプリケーションがGoogleアカウント内の機密情報へのアクセスをリクエストしていることを通知するウィンドウが表示されます。 Advancedをクリックし、Go to Untitled project (unsafe)リンクを選択します。
  4. リンクを選択すると、アプリケーションを信頼することを確認する新しいウィンドウが開きます。 「許可」をクリックして続行します。
  5. これで、設定が完了しました。 GoogleシートのOracle Autonomous Databaseメニューから「登録」を選択します。
    これにより、Googleシートに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の説明は以下のとおりです
    図adb-google-wizard.pngの説明
  6. 「認可」を選択します。

資格証明を正常に認可した後、Oracle Autonomous Databaseの下の「接続」、「直接SQL」、「データ分析」、「分析とレポート」 「シートをクリア」、「すべてのシートを削除」、「Autonomous Databaseについて」および「サインアウト」メニュー項目を表示できます。

親トピック: Oracle Autonomous Database for Google Sheets