ファイルからデータを取得する
Kotlin DataFrameライブラリを使用すると、非構造化データと構造化データの両方を扱うことができます。 データの変換には、.add()、.split()、.convert()、.parse() などのメソッドを使用できます。 さらに、このツールセットにより、CSV、JSON、XLS、Parquet、Apache Arrowなど、さまざまな構造化ファイル形式からのデータの取得や操作が可能になります。 サポートされているすべての形式については、DataFrameのドキュメントを参照してください。
このガイドでは、複数の例を通じてデータの取得、加工、処理を行う方法を学びます。
開始する前に
IntelliJ IDEA 2026.2以降、Kotlin NotebookはIDEにバンドルされなくなり、JetBrainsによる公式サポートも終了します。 ソースコードは引き続きGitHubで入手可能です。
詳細はブログ投稿をご覧ください。
このチュートリアルに沿って進めるには:
File | New | Kotlin Notebook を選択します。
Kotlin DataFrameをインポートします:
kotlin%use dataframeノートブック内でDataFrameライブラリとそのAPIを確実に利用できるようにするため、他のコードセルよりも先に
%use dataframeの行を含むコードセルを実行してください。
このチュートリアルは、DataFrameを Gradle または Maven の依存関係として使用して進めることもできます。
データの取得
ファイルからデータを取得するには、DataFrame.read() 関数を使用します:
val movies = DataFrame.read("movies.csv")DataFrame.read() 関数は、ファイルの拡張子と内容に基づいて入力形式を自動検出します。
また、追加の引数を渡して、DataFrameライブラリによる入力データの読み込み方法を制御することもできます。 例えば、次のコードはCSVファイルに対してカスタム区切り文字(;)を指定しています:
val movies = DataFrame.read("movies.csv", delimiter = ';')その他の対応ファイル形式やさまざまな読み込み関数の包括的な概要については、Kotlin DataFrameライブラリのドキュメントを参照してください。
データの表示
データを取得したら、それを表示できます。最も簡単な方法は、データを変数に格納してからそれを返すことです:
val jsonDf = DataFrame.read("jsonFile.json")
jsonDfこのコードを実行すると、ファイルからのデータがインタラクティブなテーブルとして表示されます:

このビューを使用して、値の確認、列名のチェック、データセットの状態の把握を簡単に行うことができます。
データ構造の確認
データの構造やスキーマについての詳細を把握するには、DataFrame変数に対して .schema() 関数を使用します。
例えば、jsonDf.schema() を実行して、JSONデータセット内の各列の型を一覧表示します:

オートコンプリート機能を使用することもできます。これにより、DataFrameのプロパティに素早くアクセスして操作することができます。データを読み込んだ後、DataFrame変数の後ろにピリオド(.)を入力するだけで、利用可能な列とその型の一覧が表示されます。

データの加工
Kotlin DataFrameは、データセットを加工するためのさまざまな操作を提供しています。 例えば、グループ化、フィルタリング、更新、新しい列の追加などです。これらの機能はデータ分析に不可欠であり、データを効率的に整理、クレンジング、変換できます。
例として、movies.csv データセットを見てみましょう。このデータセットでは、同じセル内に映画のタイトルと公開年が格納されています。ここでの目的は、分析しやすくするためにこのデータセットを加工することです:
データの読み込み
.read()関数を使用してファイルをDataFrameに読み込みます:kotlinval movies = DataFrame.read("movies.csv")列の追加
title列から公開年を抽出するために、新しいyear列を追加します:kotlinval moviesWithYear = movies .add("year") { "\\d{4}".toRegex() .findAll(title) .lastOrNull() ?.value ?.toInt() ?: -1 } moviesWithYear値の更新
映画のタイトルから公開年を削除するために、
title列を更新します:kotlinval moviesTitle = moviesWithYear .update("title") { "\\s*\\(\\d{4}\\)\\s*$".toRegex().replace(title, "") } moviesTitleこのコードにより、映画のタイトルが1つの列に保持され、公開年が別の列に移動されます。
行のフィルタリング
特定のデータに絞り込むには、
.filter()関数を使用します。例えば、1986年より後に公開された映画のみを残すには、次を実行します:kotlinval newMovies = moviesTitle.filter { year >= 1996 } newMovies列の削除
不要な列を削除するには、
.remove()関数を使用します:kotlinval refinedMovies = newMovies.remove { movieID } refinedMovies
比較のために、加工前のデータセットを以下に示します:

加工後のデータセット:

その他のユースケースや詳細な例については、Kotlin Dataframeのサンプルコードを参照してください。
データのエクスポート
データを加工した後は、簡単にエクスポートできます。
この目的のために、さまざまな .write() 関数を利用できます。CSV、JSON、XLS、XLSX、Apache Arrow、さらにはHTMLテーブルなど、複数の形式での保存がサポートされています。 サポートされているすべての形式については、DataFrameのドキュメントを参照してください。 これは、分析結果の共有、レポートの作成、さらなる分析のためのデータ提供に特に役立ちます。
例えば、結果を次のように保存してみましょう:
.writeJson()関数を使用したJSONファイル形式:kotlinrefinedMovies.writeJson("movies.json").writeCsv()関数を使用したCSVファイル形式:kotlinrefinedMovies.writeCsv("movies.csv").writeArrorIPC()および.writeArrorFeather()関数を使用した Apache Arrowファイル形式:kotlinrefinedMovies.writeArrowIPC("movies.arrow") refinedMovies.writeArrowFeather("movies.feather")
.toStandaloneHTML() 関数を使用して、ブラウザでスタンドアロンのHTMLテーブルを開くこともできます:
refinedMoviesDf
.toStandaloneHTML(DisplayConfiguration(rowsLimit = null))
.openInBrowser()次のステップ
- Kandyライブラリを使用したデータの可視化を試す
- Kandyを使用したデータの可視化でデータ可視化の詳細を確認する
- Kotlinでのデータサイエンスおよび分析に利用可能なツールやリソースの包括的な概要については、データ分析のためのKotlinおよびJavaライブラリを参照してください
