接続の追加

自律型データベースへの接続を手動で作成できます。接続を追加すると、Autonomous Databaseのスキーマに接続するデータベースへの接続資格証明を指定できます。

この接続により、Excelからデータベースを使用できます。
  1. 「接続の管理」ドロップダウン・アイコンの「接続の追加」メニューをクリックして、接続を追加します。「新規接続を追加」ダイアログ・ボックスが開きます。
  2. 「新規接続を追加」ダイアログ・ボックスで、次のフィールドを指定します:
    • 接続名: Autonomous Database URLの接続名を入力します。読みやすくするために、OracleではURLとは異なる名前を使用することをお薦めします。
    • Autonomous DatabaseのURL: 接続先のAutonomous DatabaseのURLを入力します。Autonomous DatabaseのWeb UIからURL全体をコピーします。たとえば、次のリンク"https://<hostname>-<databasename>.adb.<region>.oraclecloudapps.com/"を入力またはコピーしてデータベースに接続します。これは管理者によって提供されます。
    • スキーマ名: この接続に使用するスキーマを入力します。
    • OAuthクライアントID:この接続のクライアントIDを入力します。「接続用のクライアントIDの生成」を参照して、この暗黙的な接続のクライアントIDを生成し、このフィールドに貼り付けます。
  3. 「保存」をクリックして接続を保存します。

これで、新しい接続を表示できるようになります。

接続用のクライアントIDの生成

OAuthクライアント・キーは、SQLを使用して生成されます。

「暗黙的な接続問合せテンプレートのコピー」ボタンで、接続問合せテンプレートをコピーします。このテンプレートには、OAuthクライアントIDを生成するPL/SQLコードが含まれています。クライアントIDを作成するには、このPL/SQLコードをワークシート・エディタでコピーおよび実行します。

この項では、クライアントIDを生成する方法について説明します。

  1. Database Actionsの起動パッドの「開発」タブで、「SQL」ペインを選択します。「SQL」ページが開きます。
    sql-card.pngの説明が続きます

  2. 前の項の説明に従ってコピーした暗黙的な接続問合せテンプレートを貼り付けます。次の図に、暗黙的な接続問合せテンプレートの例を示します。
    paste-template.pngの説明が続きます

  3. ワークシート・エディタで、変数名フィールドのテキスト"[PROVIDE_A_UNIQUE_CLIENT_NAME]"を希望するクライアント名に置き換えます。名前は一意にする必要があります。たとえば、他のOAuthクライアントは、このフィールドに指定した名前と同じ名前を持つことはできません。
  4. ワークシート・エディタで、テキスト"[PROVIDE_THE_SCHEMA_NAME]"を変数名フィールドのスキーマ名に置き換えます。
  5. クライアントの作成PL/SQLプロシージャのサポートURIを、OAuthクライアントの作成に使用した電子メールに置き換えることができます。たとえば、"youremail@yourorg.com"です。
    ノート

    テンプレートを変更しないでください。そうしないと、クライアントIDの作成に失敗するエラーが表示される可能性があります。p_redirect_uriフィールドは自動生成され、Autonomous Databaseごとに異なります。

  6. ワークシート・ツールバーの「スクリプトの実行」アイコンをクリックして、PL/SQLコードを実行します。
    worksheet-editor.pngの説明が続きます

  7. PL/SQLコードの実行後に「スクリプト出力」タブに表示される出力例を次に示します。
    script-output.pngの説明が続きます

  8. スクリプト出力の最初の行からクライアントIDをコピーします。暗黙的な接続問合せテンプレートで指定したクライアント名に相当するクライアントIDをコピーすることもできます。前述の例のクライアントID OohrmcjhzmXh3skoeEusXA...
  9. 「新規接続を追加」ダイアログ・ボックスの「クライアントID」値フィールドにクライアントIDを貼り付けます。詳細は、接続の追加を参照してください。
新しい接続を作成したら、「接続」パネルに追加した接続を表示できます。パネル内の接続には、次の情報がリスト表示されます:
  • 「接続」リストには、接続先のAutonomous Databaseのデータベースおよびスキーマ名が表示されます。
  • 接続が接続されているかどうかを識別する、異なる色で強調表示された接続リスト。緑色の強調表示された接続リストは、アクティブな接続を示します。灰色で強調表示されている接続リストは、接続が成功していないことを示します。
  • 接続パネルの右端にある「アクション」アイコン。

adp-connection-panel.pngの説明が続きます

接続の「アクション」アイコンをクリックします。選択した接続に対して次のアクションを実行できます:
  • 接続: 「接続」をクリックして、アドインをAutonomous Databaseに接続します。これにより、接続先のAutonomous DatabaseであるOracle Database Actionsのログイン・ページが開きます。

    「ユーザー名」フィールドにスキーマ名を入力し、対応するパスワードを入力します。

    ノート

    • Oracle Autonomous Database for Excelでは、データベースに初めてログインするときに権限を求められます。「承認」を選択してログインを続行します。

    Autonomous DatabaseでのExcelの認可が成功したことを示す通知ページが表示されます。

  • 編集:このボタンを使用すると、既存の接続を編集できます。「編集」をクリックして、接続ベースの情報を表示または編集します。「編集」を選択すると、接続を追加したときに表示されるのと同じダイアログが開きます。既存の接続の接続名、Autonomous DatabaseのURL、スキーマ名、OAuthクライアントIDなど、情報の詳細を編集します。
  • 複製: 「複製」は、「接続」パネルに表示される接続のリストから接続をクローニングする場合に選択します。これにより、詳細を再度入力しなくても接続のコピーが作成されます。
  • 切断: 「切断」は、接続から切断する場合に選択します。接続が切断されると、接続名の横にクロス・マークが表示されます。これは、接続が終了したことを示します。
  • 削除: 「削除」は、「接続」パネルに表示される接続のリストから接続を削除する場合に選択します。

Excelアドイン・パネルの管理


position-addin.pngの説明が続きます

ウィザード・ペインのドロップダウンで「移動」をクリックして、ウィザードを任意の場所に移動します。

ドロップダウンのサイズ変更オプションは、問合せウィンドウのサイズを変更します。このオプションでは、両矢印を横に移動することでウィザード・ウィンドウのサイズを変更できます。矢印を左に移動するとウィザードが拡大され、右にドラッグすると縮小されます。

ウィザードを閉じるには、「閉じる」をクリックします。