> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Excel

> このページは、Excel デスクトップ版およびExcel Web 版を含む、Excel 用のCData Connect Spreadsheets アドインをインストールおよび設定する手順の概要を説明します。インストールが完了すると、Excel はCData Connect Spreadsheets アカウントに接続されたデータソースからデータを取得できます。

## Prerequisites

CData Connect Spreadsheets でExcel を設定し、使用する前にデータソースをCData Connect Spreadsheets アカウントに接続する必要があります。詳しくは、[接続の設定](#接続の設定)を参照してください。

**Connect AI ユーザーのみ：** また、ワークスペースとDerived View をインポートすることもできます。ワークスペースを作成するには、[Workspaces](/ja/Workspaces#ワークスペースを追加) の指示に従ってください。Derived view を作成するには（管理者のみ）、[Derived View の作成](/ja/Data-Explorer#derived-view-の作成)の指示に従ってください。

## アドインのインストール

Excel アドインは[CData Connect Spreadsheets のダッシュボート](#cdata-connect-spreadsheets-ダッシュボードから)もしくは[Excel](#microsoft-excel-から) からインストールできます。

### CData Connect Spreadsheets ダッシュボードから

<Steps>
  <Step>
    ダッシュボードの **Integrations** ページを開きます。
  </Step>

  <Step>
    **Excel** タイルを見つけるか、検索バーを使用します。
  </Step>

  <Step>
    **Get Started** をクリックします。Excel のアドインページが開きます。
  </Step>

  <Step>
    **今すぐ入手する** をクリックします。プロンプト画面が表示された場合はMicrosoft アカウントでサインインします。
  </Step>

  <Step>
    **開始** ページで、（Excel Web 版用）**Office Online を使用してみてください** をクリックします。

    <Frame>
      <img src="https://mintcdn.com/cdata/bW2_IPnFDk_aW2FG/ja/images/excel_365_switch.png?fit=max&auto=format&n=bW2_IPnFDk_aW2FG&q=85&s=b4f7486eba2e7ed442567632c6576983" alt="Excel 365 switch" width="881" height="439" data-path="ja/images/excel_365_switch.png" />
    </Frame>

    次に、**Excel Online で開く** をクリックします。
    Excel デスクトップ版を使用している場合は、**Excel で開く**をクリックします。

    <Frame>
      <img src="https://mintcdn.com/cdata/bW2_IPnFDk_aW2FG/ja/images/excel_download_online.png?fit=max&auto=format&n=bW2_IPnFDk_aW2FG&q=85&s=972ab2adf177f6c6cd898ee9bbe704a0" alt="Excel Download Online" width="881" height="439" data-path="ja/images/excel_download_online.png" />
    </Frame>
  </Step>

  <Step>
    アドインを認証するよう指示がある場合は、認証します。
  </Step>

  <Step>
    どちらのバージョンのExcel でも、ブックを開くか新しいブックを作成します。
  </Step>

  <Step>
    ナビゲーションリボンから **ホーム** タブを選択し、**アドイン** をクリックします。**個人用アドイン** ウィンドウが開きます。

    <Frame>
      <img src="https://mintcdn.com/cdata/0o_7a3Hya0sbnsUJ/ja/images/ExcelMyAddin.png?fit=max&auto=format&n=0o_7a3Hya0sbnsUJ&q=85&s=689d2f5c7b5c1c9c62930e4b32b0f441" alt="Excel My Add-in" width="283" height="182" data-path="ja/images/ExcelMyAddin.png" />
    </Frame>
  </Step>

  <Step>
    [CData Connect Spreadsheets への接続](#cdata-connect-spreadsheets-への接続)の手順へ続きます。
  </Step>
</Steps>

### Microsoft Excel から

<Steps>
  <Step>
    Microsoft Excel（デスクトップ版またはWeb 版）で新規もしくは既存のブックを開きます。
  </Step>

  <Step>
    ナビゲーションリボンの**ファイル**タブをクリックします。
  </Step>

  <Step>
    **アドインを取得**をクリックします。表示されるアドインのリストから**すべて**をクリックします。
  </Step>

  <Step>
    ウィンドウで*CData* を検索します。検索結果で**CData Connect Spreadsheets** の隣の**追加**をクリックします。

    <Frame>
      <img src="https://mintcdn.com/cdata/bW2_IPnFDk_aW2FG/ja/images/excel_addin_store.png?fit=max&auto=format&n=bW2_IPnFDk_aW2FG&q=85&s=5978774da2f7ad86f19c0332fbdacd53" alt="Excel Add-in Store" width="677" height="308" data-path="ja/images/excel_addin_store.png" />
    </Frame>
  </Step>

  <Step>
    **続行**をクリックしてライセンス条項に同意します。Excel ブックで認証ダイアログが開きます。
  </Step>

  <Step>
    **Authorize** をクリックします。
  </Step>

  <Step>
    資格情報を入力してダイアログの**Continue** をクリックします。
  </Step>

  <Step>
    [CData Connect Spreadsheets への接続](#cdata-connect-spreadsheets-への接続)の手順へ続きます。
  </Step>
</Steps>

## CData Connect Spreadsheets への接続

Excel アドインをインストールしたら、以下の手順に従ってCData Connect Spreadsheets アカウントに接続します：

<Steps>
  <Step>
    Excel のナビゲーションリボンの**データ**タブを開き**CData Connect Spreadsheets** をクリックします。

    <Frame>
      <img src="https://mintcdn.com/cdata/bW2_IPnFDk_aW2FG/ja/images/excel_addin_getdata.png?fit=max&auto=format&n=bW2_IPnFDk_aW2FG&q=85&s=e218e89039b36b722597a737a4af05b5" alt="Excel Add-in Get Data" width="940" height="267" data-path="ja/images/excel_addin_getdata.png" />
    </Frame>
  </Step>

  <Step>
    CData Connect Spreadsheets アドインを承認します。
    Excel ワークブックの右側にCData アドインペインが表示されます。

    <Frame>
      <img src="https://mintcdn.com/cdata/EE4HlkSQpbRlgqOq/ja/images/connect_spreadsheets_full.png?fit=max&auto=format&n=EE4HlkSQpbRlgqOq&q=85&s=eb3f63f5cd26fd1cd29a6ea0d7c8fd9b" alt="Connect Spreadsheets Full" width="529" height="1097" data-path="ja/images/connect_spreadsheets_full.png" />
    </Frame>
  </Step>
</Steps>

## 接続の設定

まだCData Connect Spreadsheets に必要なデータを接続していない場合は、設定する必要があります。

<Steps>
  <Step>
    アドインペインで**Connections** をクリックします。**Add Connection**をクリックします。
  </Step>

  <Step>
    Excel に接続するデータ用のコネクタを選択します。
  </Step>

  <Step>
    データ接続文字列を入力します。保存して接続をテストします。
    接続に成功したら、[データのインポート](#データのインポート)ができます。
  </Step>
</Steps>

<Note>You can also use the **Connections** option to edit existing connections.</Note>

## データのインポート

CData Connect Spreadsheets からExcel へデータをインポートするには以下の手順に従います：

<Steps>
  <Step>
    **Import** をクリックします。
  </Step>

  <Step>
    ドロップダウンメニューからオプションを1つ選択します：**Connections**、**Workspaces**、**Derived Views**。次に、選択した各オプションの手順に従います。
  </Step>
</Steps>

<Note>
  ワークスペースおよびDerived view にアクセスできるのは、Connect AI ユーザーのみです。
</Note>

### Connections のインポート

<Steps>
  <Step>
    ドロップダウンリストからコネクションを選択します。
  </Step>

  <Step>
    画面の指示に沿ってクエリを作成する場合は**Query Builder** を、クエリを手動で入力する場合は**Custom SQL** を選択します。

    * Query Builder では、スキーマ（複数ある場合）、テーブル、およびカラムを選択します。カラム名で検索できます。必要に応じて[フィルタ](#フィルタ)、[ソート](#ソート)、およびLimit を設定できます。生成されたクエリを表示し、必要に応じて調整します。
    * Custom SQL では、SQL ステートメントを所定のテーブルに入力します。

    <Frame>
      <img src="https://mintcdn.com/cdata/bW2_IPnFDk_aW2FG/ja/images/excel_addin_search_columns.png?fit=max&auto=format&n=bW2_IPnFDk_aW2FG&q=85&s=119242036d5bdebfd76d6f37de2111c9" alt="Excel Add-in Search Columns" width="434" height="865" data-path="ja/images/excel_addin_search_columns.png" />
    </Frame>
  </Step>

  <Step>
    **Execute** をクリックします。
  </Step>

  <Step>
    プロンプトが表示されたら、現在のスプレッドシートまたは新しいスプレッドシートのいずれかをデータの出力先として選択します。
  </Step>
</Steps>

### Workspaces のインポート（Connect AI ユーザーのみ）

<Steps>
  <Step>
    ドロップダウンリストからワークスペースを選択します。
  </Step>

  <Step>
    画面の指示に沿ってクエリを作成する場合は**Query Builder** を、クエリを手動で入力する場合は**Custom SQL** を選択します。

    * Query Builder では、表示するワークスペースとカラムを選択します。カラム名で検索できます。必要に応じて[フィルタ](#フィルタ)、[ソート](#ソート)、およびLimit を設定できます。生成されたクエリを表示し、必要に応じて調整します。
    * Custom SQL では、SQL ステートメントを所定のテーブルに入力します。
  </Step>

  <Step>
    **Execute** をクリックします。
  </Step>

  <Step>
    プロンプトが表示されたら、現在のスプレッドシートまたは新しいスプレッドシートのいずれかをデータの出力先として選択します。
  </Step>
</Steps>

### Derived Views のインポート（Connect AI ユーザーのみ）

<Steps>
  <Step>
    画面の指示に沿ってクエリを作成する場合は**Query Builder** を、クエリを手動で入力する場合は**Custom SQL** を選択します。

    * Query Builder では、表示するワークスペースとカラムを選択します。カラム名で検索できます。必要に応じて[フィルタ](#フィルタ)、[ソート](#ソート)、およびLimit を設定できます。生成されたクエリを表示し、必要に応じて調整します。
    * Custom SQL では、SQL ステートメントを所定のテーブルに入力します。
  </Step>

  <Step>
    **Execute** をクリックします。
  </Step>

  <Step>
    プロンプトが表示されたら、現在のスプレッドシートまたは新しいスプレッドシートのいずれかをデータの出力先として選択します。
  </Step>
</Steps>

## データのリフレッシュ

データがインポートされたら、自動で定期的にリフレッシュされるように設定できます。スプレッドシートのデータを手動でリフレッシュすることも可能です。自動更新は、コミットされていないデータを上書きします。データの読み込みだけであれば自動更新は問題ありません。自動更新を有効化済みでデータを書き込む場合は、**更新**ボタンを使って変更を頻繁にコミットしてください。

自動更新が正しく機能するには、Excel ブックをブラウザで開いておく必要があります。また、ブックが15分以上アイドル状態の場合、自動更新は実行されません。

<Steps>
  <Step>
    **CData Connect Spreadsheets** 画面で**Refresh** を選択します。
  </Step>

  <Step>
    リフレッシュするデータシートを選択します。

    <Frame>
      <img src="https://mintcdn.com/cdata/0o_7a3Hya0sbnsUJ/ja/images/ExcelRefresh01.png?fit=max&auto=format&n=0o_7a3Hya0sbnsUJ&q=85&s=8c3cf66d9ca4f2361a7b8adf9132b5f2" alt="Excel Refresh 01" width="439" height="398" data-path="ja/images/ExcelRefresh01.png" />
    </Frame>
  </Step>

  <Step>
    手動でリフレッシュするには、**Refresh Now** をクリックします。自動更新を設定するには、**Auto Refresh** をクリックします。

    <Frame>
      <img src="https://mintcdn.com/cdata/0o_7a3Hya0sbnsUJ/ja/images/ExcelRefresh02.png?fit=max&auto=format&n=0o_7a3Hya0sbnsUJ&q=85&s=89646e1edc81e16654de71a2f3f53d27" alt="Excel Refresh 02" width="292" height="189" data-path="ja/images/ExcelRefresh02.png" />
    </Frame>
  </Step>
</Steps>

<Note>
  リフレッシュ間隔は時間単位で設定でき、最小間隔は1時間であることに注意してください。自動更新が失敗した場合、Excel Add-In はさらに2回自動更新を試みます。3回失敗すると、その次の自動更新は、次にユーザーが設定した間隔で試行されます。
</Note>

クエリを選択して**Remove** をクリックすることで、更新リストからクエリを削除することもできます。

## データの更新

Excel スプレッドシートから元のデータソースに変更をプッシュできます。スプレッドシートを更新するには、データに少なくとも1つの主キーが含まれていなければならないことに注意してください。また、ソースデータを更新するための適切な権限が必要です。

自動更新機能を使用している場合は、データを頻繁に更新するようにしてください。そうしないと、変更が上書きされる可能性があります。

<Note>
  CData Connect Spreadsheets はビューの更新をサポートしていません（テーブルのみ）。
</Note>

スプレッドシートのデータを更新するには、以下の手順に従います：

<Steps>
  <Step>
    Excel スプレッドシートに変更を加えます。
  </Step>

  <Step>
    **CData Connect Spreadsheets** アドインペインで**Update** をクリックします。スプレッドシート全体を更新するか、選択した行のみ更新するかを選択できます。**Confirm** をクリックします。
  </Step>
</Steps>

## Delete Data

<Note>
  CData Connect Spreadsheets does not support deletion for views (only tables).
</Note>

To delete rows from a spreadsheet, follow these steps:

<Steps>
  <Step>
    If necessary, return to the main menu of the CData Connect Spreadsheets add-in.
  </Step>

  <Step>
    Select the record(s) to delete.
  </Step>

  <Step>
    On the **CData Connect Spreadsheets** add-in pane, click **Delete**. Click **Confirm**.
  </Step>
</Steps>

## ログ

**Logs** をクリックすると以下の項目を含む直近のクエリが一覧表示されるダイアログが開きます：

* クエリを実行した日時
* クエリ結果（成功 / 失敗）
* クエリの内容とパラメータ

詳しくは[Logs](/ja/Logs) を参照してください。

## Settings

Click [**Settings**](/ja/Settings) to view and manage your profile, account details, and subscription.

## クエリの詳細設定

データをインポートする際、クエリをビルドするために[フィルタ](#フィルタ) と[ソート](#ソート) が使用できます。SQL クエリでは、詳細設定オプションの[パラメタライズドクエリ](#パラメタライズドクエリの記述)および[検索可能なスプレッドシート](#検索可能なスプレッドシートの作成)を使用できます。

### フィルタ

フィルタを追加するには、**Filters** ヘッダーの隣の **+** をクリックします。**+** を再度クリックすることでさらにフィルタを追加することができ、フィルタの横にあるゴミ箱のアイコンをクリックすると、フィルタを削除できます。

<Frame>
  <img src="https://mintcdn.com/cdata/bW2_IPnFDk_aW2FG/ja/images/excel_365_filter.png?fit=max&auto=format&n=bW2_IPnFDk_aW2FG&q=85&s=d229e9cd62ab72353686112edadbadc4" alt="Excel 365 filter" width="409" height="131" data-path="ja/images/excel_365_filter.png" />
</Frame>

各フィルタには以下の3つの入力項目があります：

* **Column**—フィルタをかけたいカラムをテーブルから選択します。
* **Operator**—フィルタが実行するオペレーションを選択します。オプション：*equals*、*does not equal*、*contains*、*does not contain*、*less than*、*less than or equal to*、*greater than*、*greater than or equal to*
* **Value**—フィルタ操作の値を表示します。

例えば、AccountValues が\$100,000を超えるものを取り出したい場合、Column を*AccountValues*、Operator を*greater than*、そしてValue を*100,000* にそれぞれ設定します。この設定をすることでクエリを実行したときにフィルタにマッチした結果のみが返されます。

フィルタのパラメータを入力すると、画面下部の**Generated Query** が自動的にアップデートされます。

### ソート

クエリ結果にソートルールを追加するには、**Sort By** ヘッダーの隣の **+** をクリックします。**+** を再度クリックすることでさらにソートルールを追加することができ、ソートルールの横にあるゴミ箱のアイコンをクリックすると、ソートルールを削除できます。

<Frame>
  <img src="https://mintcdn.com/cdata/bW2_IPnFDk_aW2FG/ja/images/excel_365_sort.png?fit=max&auto=format&n=bW2_IPnFDk_aW2FG&q=85&s=dc9c23e0c4478119f945e5f2262b179d" alt="Excel 365 Sort" width="398" height="114" data-path="ja/images/excel_365_sort.png" />
</Frame>

各ソートルールは**Column** と**Order**（昇順または降順）の選択が必要です。複数のソートルールを追加する場合は、ルールが表示されている順で結果がソートされます。クエリは、最初のルールを最も優先してソートし、次に2番目のルール、といった順番でソートされます。

ソートのパラメータを入力すると、画面下部の**Generated Query** が自動的にアップデートされます。

### パラメタライズドクエリの記述

カスタムSQL ステートメントでセルを参照することで、動的スプレッドシートを作成できます。Excel アドインは、ステートメントをパラメータ化されたクエリとして実行します。シート内の値を変更すると、Excel アドインは新しいクエリを実行します。

### 検索可能なスプレッドシートの作成

パラメータ化されたSELECT WHERE クエリを使用して、セルを編集するとデータを動的にフィルタリングするスプレッドシートを作成します。次のフィルタ条件は`@InputSheet!A2` パラメータを参照します。これは、シート`InputSheet` のセル`A2` です。`@` プレフィックスは、`Industry` が必須パラメータであることを示します。

```bash theme={null}
SELECT BillingState, Name FROM Account WHERE Industry = @InputSheet!A2
```