頻度分析 (Frequency)

[Teradata Vantage - Vantage Analytics Library](https://docs.teradata.com/r/Vantage-Analytics-Library-User-Guide/January-2022)[2022/9/22時点]の翻訳です。
(リリース番号 : 2.1.1 | リリース日 : January 2022)
> この記事はVantageアナリティクスライブラリ シリーズのコンテンツです。

# 概要
頻度分析は、各値の出現回数を個別に、または組み合わせてカウントします。

# 前提条件
・Teradata Vantageインスタンスにアクセスできること。
・Vantage アナリティクス・ライブラリがインストールされていること。

::: note info
Vantage アナリティクス・ライブラリのインストールについて、既にVantageを導入頂いているお客様はTeradataサポートサービスにお問い合わせください。
Vantage Express (評価版)やクラウドサービスのDIYでご利用頂く場合は[Teradata Dounload](https://downloads.teradata.com/download)からダウンロードし利用可能です。
Vantage アナリティクス・ライブラリのインストール手順は「[Vantageアナリティクス・ライブラリのインストール](https://qiita.com/ykswi/items/12d0da2ac69b4b161881#vantage%E3%82%A2%E3%83%8A%E3%83%AA%E3%83%86%E3%82%A3%E3%82%AF%E3%82%B9%E3%83%A9%E3%82%A4%E3%83%96%E3%83%A9%E3%83%AA%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB)」の記事に従い行います。
:::

# データの準備
## サンプルデータの入手とデータベースへの格納方法
こちらの「[チュートリアル用のサンプルデータを用意する](https://qiita.com/tmsky/items/4d86ca35aef753290020)」を参照ください。

# 実行方法
## SQLから実行する場合の例
```SQL
CALL td_analyze (
  'frequency',                              /* 分析手法　*/
  '
  database        = QID;                    /* データベース名 */
  tablename       = Superstore;             /* テーブル名 */
  columns         = Category,Sub_Category;  /* カラムリスト */
  '
);
```
:::note information
出力結果をテーブルに書き込む場合は以下オプションを指定可能です。
outputdatabase = 出力データベース名;
outputtablename = 出力テーブル名; 
overwrite = {true | false}; --- 未指定の場合はtrueで上書きします
:::
## 出力結果
|xtbl|xcol|xval|xcnt|xpct|
|:-|:-|:-|:-|:-|
|Superstore|Category|Office Supplies|6026|60.29617770662397|
|Superstore|Category|Furniture|2121|21.22273364018411|
|Superstore|Category|Technology|1847|18.481088653191915|
|Superstore|Sub_Category|Binders|1523|15.239143486091654|
|Superstore|Sub_Category|Paper|1370|13.708224934960976|
|Superstore|Sub_Category|Furnishings|957|9.57574544726836|
|Superstore|Sub_Category|Phones|889|8.895337202321393|
|Superstore|Sub_Category|Storage|846|8.465079047428457|
|Superstore|Sub_Category|Art|796|7.964778867320392|
|Superstore|Sub_Category|Accessories|775|7.754652791675005|
|Superstore|Sub_Category|Chairs|617|6.17370422253352|
|Superstore|Sub_Category|Appliances|466|4.6627976786071645|
|Superstore|Sub_Category|Labels|364|3.642185311186712|
|Superstore|Sub_Category|Tables|319|3.1919151490894535|
|Superstore|Sub_Category|Envelopes|254|2.5415249149489694|
|Superstore|Sub_Category|Bookcases|228|2.2813688212927756|
|Superstore|Sub_Category|Fasteners|217|2.1713027816690014|
|Superstore|Sub_Category|Supplies|190|1.9011406844106464|
|Superstore|Sub_Category|Machines|115|1.1506904142485492|
|Superstore|Sub_Category|Copiers|68|0.6804082449469682|

## 出力結果の説明
|カラム名|データタイプ|説明|
|:-|:-|:-|
|xdb|VARCHAR (128)|データベース名|
|xtbl|VARCHAR (128)|テーブル名|
|xcol|VARCHAR (128)|カラム名|
|xval|VARCHAR (256)|値|
|xcnt|FLOAT|レコード数|
|xpct|FLOAT|値の割合|

# おわりに
:::note information
サンプルコードはSQL関数から掲載し順次Pythonコードも掲載していく予定です。
:::

:::note warn
警告
この本書は[Teradata Vantageドキュメンテーション](https://docs.teradata.com/)よりトピックに必要な情報を抜粋したものです。掲載内容の正確性・完全性・信頼性・最新性を保証するものではございません。正確な内容については、原本をご参照下さい。
また、修正が必要な箇所や、ご要望についてはコメントをよろしくお願いします。
:::

#### Teradata Vantageへのお問合せ
[Teradata Vantage へのお問合せ](https://www.teradata.jp/About-Us/Contact)