> ## 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.

# MicroStrategy

> このページでは、MicroStrategy を Connect AI に接続する手順を説明します。接続には Connect AI Virtual SQL Server API または Connect AI OData エンドポイントのいずれかを使用できます。Virtual SQL Server API は大規模なデータセットでより優れたパフォーマンスを発揮し、OData は小規模なデータセットで良好に機能します。

## Virtual SQL Server API 経由で接続するための前提条件

Virtual SQL Server API 経由で接続する前に、以下を実施する必要があります：

* データソースを Connect AI アカウントに接続します。詳細は [Sources](/ja/Sources) を参照してください。
* [Settings](/ja/Settings#personal-access-tokens) ページで Personal Access Token (PAT) を生成します。認証時にパスワードとして使用するため、控えておいてください。

## Virtual SQL Server API 経由で Connect AI に接続する

MicroStrategy から Connect AI Virtual SQL Server API への接続を確立するには、以下の手順に従います。

<Steps>
  <Step>
    MicroStrategy にログインします。
  </Step>

  <Step>
    **Add External Data** > **Databases** をクリックします。
  </Step>

  <Step>
    **Import Option** を **Select Tables** に設定します。
  </Step>

  <Step>
    **Import from Tables** ウィザードで「+」をクリックして新しいデータソースを追加します。
  </Step>

  <Step>
    コネクションプロパティを設定します。

    <Frame>
      <img src="https://mintcdn.com/cdata/tJfdD354GT5ojxph/ja/images/microstrategy_client_01.png?fit=max&auto=format&n=tJfdD354GT5ojxph&q=85&s=aada15194ddc7fa01ca858f30e425158" alt="MicroStrategy Client 01" width="1136" height="660" data-path="ja/images/microstrategy_client_01.png" />
    </Frame>

    * **Database**—**SQL Server** を選択します
    * **Version**—**SQL Server 2017** を選択します
    * **Server Name**—*tds.cdata.com* を入力します
    * **Port Number**—*14333* を入力します
    * **Database Name**—接続したい Connect AI データソースの Connection Name を入力します。例：*Salesforce1*
    * **User**—Connect AI のユーザー名を入力します。ユーザー名は、Connect AI の画面の右上に表示されています。例：*[test@cdata.co.jp](mailto:test@cdata.co.jp)*
    * **Password**—[Settings](/ja/Settings#personal-access-tokens) ページで生成した PAT を入力します。
    * **Data Source Name**—データソースの名前を入力します
  </Step>

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

  <Step>
    新しいデータソースを右クリックし、**Edit Catalog Options** を選択します。

    <Frame>
      <img src="https://mintcdn.com/cdata/YITfVTwoqsOOaiRq/ja/images/microstrategy_client_02.png?fit=max&auto=format&n=YITfVTwoqsOOaiRq&q=85&s=1c95e8d85712db393d816a51d3876ebd" alt="MicroStrategy Client 02" width="1136" height="660" data-path="ja/images/microstrategy_client_02.png" />
    </Frame>
  </Step>

  <Step>
    SQL カラム取得クエリを編集し、WHERE 句に `TABLE_SCHEMA = '#?Schema_Name?#'` を含めます。完全なクエリは以下のとおりです。

    ```bash theme={null}
    SELECT DISTINCT 
     TABLE_SCHEMA NAME_SPACE, 
     TABLE_NAME TAB_NAME, 
     COLUMN_NAME COL_NAME, 
     (CASE 
         WHEN 
         (DATA_TYPE LIKE '%char' AND (CHARACTER_SET_NAME='utf8' OR CHARACTER_SET_NAME='usc2')) 
         THEN 
         CONCAT('a',DATA_TYPE) 
         ELSE 
         DATA_TYPE 
     END) DATA_TYPE, 
     CHARACTER_MAXIMUM_LENGTH DATA_LEN, 
     NUMERIC_PRECISION DATA_PREC, 
     NUMERIC_SCALE DATA_SCALE 
     FROM 
     INFORMATION_SCHEMA.COLUMNS 
     WHERE 
     TABLE_NAME 
     IN 
     (#TABLE_LIST#) AND TABLE_SCHEMA='#?Schema_Name?#' 
     ORDER BY 
     1,2,3
    ```
  </Step>

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

  <Step>
    新しいデータソースを選択し、仮想データベース（SharePoint1 など）に対応する Namespace を選択します。

    <Frame>
      <img src="https://mintcdn.com/cdata/YITfVTwoqsOOaiRq/ja/images/microstrategy_client_03.png?fit=max&auto=format&n=YITfVTwoqsOOaiRq&q=85&s=25e33cc0e9b98e77e94db206c550db85" alt="MicroStrategy Client 03" width="1136" height="660" data-path="ja/images/microstrategy_client_03.png" />
    </Frame>
  </Step>

  <Step>
    ペインにテーブルをドラッグして挿入します。
  </Step>

  <Step>
    **Finish** をクリックし、ライブ接続のオプションを選択します。
  </Step>

  <Step>
    **Create Dossier** をクリックします。

    <Frame>
      <img src="https://mintcdn.com/cdata/YITfVTwoqsOOaiRq/ja/images/microstrategy_client_04.png?fit=max&auto=format&n=YITfVTwoqsOOaiRq&q=85&s=9f1dcf596f121722ccf0bd94b4e88aef" alt="MicroStrategy Client 04" width="1136" height="660" data-path="ja/images/microstrategy_client_04.png" />
    </Frame>
  </Step>

  <Step>
    接続したデータの新しい視覚化を作成できるようになりました。
  </Step>
</Steps>

## OData エンドポイント経由で接続するための前提条件

OData エンドポイント経由で Connect AI に接続する前に、以下を実施する必要があります：

* データソースを Connect AI アカウントに接続します。詳細は [Sources](/ja/Sources) を参照してください。
* [ワークスペース](/ja/Workspaces) を作成します。後ほど、そのページの **OData Service URL**（*`https://cloud.cdata.com/api/odata/{workspace_name}`*）を該当のワークスペース名と共に使用して接続を確立します。
* [Settings](/ja/Settings#personal-access-tokens) ページで Personal Access Token (PAT) を生成します。認証時にパスワードとして使用するため、控えておいてください。

## OData エンドポイント経由で Connect AI に接続する

OData プロトコルを使用して Connect AI に接続するには、以下の手順に従います。

<Steps>
  <Step>
    MicroStrategy にログインします。
  </Step>

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

  <Step>
    **Data Sources** で **Data from URL** を選択します。

    <Frame>
      <img src="https://mintcdn.com/cdata/YITfVTwoqsOOaiRq/ja/images/microstrategy_client_data_URL.png?fit=max&auto=format&n=YITfVTwoqsOOaiRq&q=85&s=167f398d0437d3e5f6722078d1395349" alt="MicroStrategy Client Data URL" width="918" height="349" data-path="ja/images/microstrategy_client_data_URL.png" />
    </Frame>
  </Step>

  <Step>
    **Data from URL** ダイアログで、コネクションプロパティを設定します。

    * テキストボックスに、ワークスペースの **Endpoints** ダイアログからコピーした **OData URL** を貼り付けます。URL は次の形式です：`https://cloud.cdata.com/api/odata/{workspace_name}`。
    * ドロップダウンリストから **OData** を選択します。

    <Frame>
      <img src="https://mintcdn.com/cdata/YITfVTwoqsOOaiRq/ja/images/microstrategy_client_odata.png?fit=max&auto=format&n=YITfVTwoqsOOaiRq&q=85&s=8bb431c266280f3baa1fcb3c5c8d1564" alt="MicroStrategy Client OData" width="1223" height="672" data-path="ja/images/microstrategy_client_odata.png" />
    </Frame>
  </Step>

  <Step>
    **Add** をクリックして新しいコネクタを追加します。
  </Step>

  <Step>
    **Prepare Data** をクリックしてデータのプレビューを表示します。

    <Frame>
      <img src="https://mintcdn.com/cdata/YITfVTwoqsOOaiRq/ja/images/microstrategy_client_preview.png?fit=max&auto=format&n=YITfVTwoqsOOaiRq&q=85&s=a355a80b36ff0ac0af6ecc7876a7be2a" alt="MicroStrategy Client Preview" width="1610" height="822" data-path="ja/images/microstrategy_client_preview.png" />
    </Frame>
  </Step>

  <Step>
    コネクタの追加が完了したら、**Finish** をクリックします。
  </Step>

  <Step>
    接続したデータの新しい視覚化を作成できるようになりました。

    <Frame>
      <img src="https://mintcdn.com/cdata/YITfVTwoqsOOaiRq/ja/images/microstrategy_client_visualization.png?fit=max&auto=format&n=YITfVTwoqsOOaiRq&q=85&s=65fdde946bb327b3d3e389b3c5fa7692" alt="MicroStrategy Client Visualization" width="912" height="476" data-path="ja/images/microstrategy_client_visualization.png" />
    </Frame>
  </Step>
</Steps>