90分のハンズオン

Streamlit勉強会

基本からSnowflake連携まで

きょう作るもの

Snowflakeのテーブルを、
Streamlitアプリの画面に。

画面をつくる → データにつなぐ → データを見る

完成イメージ / 架空データ

Snowflakeのテーブル表示

項目件数
データ A120
データ B85

HAGAKURE PROGRAMMING塾

侍
侍ガイド・コツ
忍者
忍者舞台裏
忍者
忍者落とし穴
町娘
町娘ここがポイント

きょうのゴール

「自分のPCで、データが見えた!」まで進みましょう。

90 分後

できるようになること

自分のPCで、Snowflakeのデータを
Streamlitの画面に表示できる。

  • ① Streamlitの基本
  • ② 表・グラフ・サイドバーでミニアプリ
  • ③ Snowflakeに接続してクエリ
町娘

ここがポイント

きょうの到達点は、
データを画面に出すこと。

侍

侍のコツ

まずは小さく動かして、
一歩ずつつなげましょう。

事前準備

Python環境は準備済み。その環境に、必要なライブラリを入れます。

1

Python環境(venv / pip)環境構築はできている前提で進めます。

2

事前にインストールpip install streamlit snowflake-snowpark-python

3

Snowflakeアカウントメールアドレスで無料トライアルを作成。クレジットカードは不要です。

4

無料トライアルは30日間申込ページでは $400 分の無料クレジットを案内しています。

侍

侍のコツ

アカウントがまだなくても大丈夫。
後半は講師デモを見ながら、流れをつかみましょう。

アジェンダ

前半は画面づくり、後半はSnowflake。90分でつないでいきます。

0:00–0:05 オープニング・ゴール 5分
0:05–0:25 Streamlitの基本 20分
0:25–0:45 表・グラフ・サイドバーでミニアプリ 20分
0:45–0:50 ひと休み 5分
0:50–1:20 Snowflake:接続・クエリ・絞り込み 30分
1:20–1:30 振り返り・次の一歩・Q&A 10分

侍のコツ:アカウントがまだない方は、後半は講師デモで流れをつかみましょう。

Streamlitってなに?

Pythonスクリプトを、ブラウザで使えるWebアプリに。
Streamlitは、オープンソースのPythonライブラリです。

1

Pythonで書く

いつものPythonで、
表示したい内容を書きます。

2

Streamlitが画面に

スクリプトから、
Webアプリの画面をつくります。

3

ブラウザで使う

できた画面を、
ブラウザで見て、操作します。

町娘

ここがポイント

HTML・CSS・JavaScriptを
自分で書かなくてもOK。

侍

侍のコツ

まずは、タイトルと文章だけ。
次のページで動かしてみましょう。

Hello Streamlit!

下のコードを app.py に保存。
ターミナルで起動して、ブラウザの画面を見てみましょう。

app.py
import streamlit as st

st.title("はじめての Streamlit")
st.write("Pythonが、そのままWebアプリになる。")
侍

侍のコツ

ターミナルで実行:
streamlit run app.py

忍者 忍者

忍者の確認ポイント

app.py を保存してから、
同じフォルダで起動しましょう。

画面に出す

見出し・文章・装飾。まずは、この3つを使い分けましょう。

app.py
import streamlit as st

st.title("見出し")
st.write("普通の文章や、数値・表も出せます。")
st.markdown("**太字**やリストも書けます。")

st.title

ページの見出しを
大きく表示します。

st.write

文章だけでなく、
数値や表も表示できます。

st.markdown

Markdownで装飾。
太字やリストを書けます。

app.py に足して、表示の違いを見比べてみましょう。

ウィジェット

入力・選択・クリックを、Pythonの値として受け取れます。

st.text_input

なまえ:はなこ

文字列を返す

st.slider

年齢:30(0〜100)

st.selectbox

りんご▼

選んだ値を返す

st.button

送信

クリックしたとき True

app.py
import streamlit as st

name = st.text_input("なまえ")
age = st.slider("年齢", 0, 100, 30)
fruit = st.selectbox("好きなフルーツ", ["りんご", "みかん", "ぶどう"])
if st.button("送信"):
    st.write(name, age, fruit)

操作するたび、上から下へ

ウィジェットを操作すると、スクリプト全体が最初から再実行されます。

1

実行

Pythonを
上から下へ実行。

→
2

表示

実行結果が
画面に表示される。

→
3

操作

入力・選択・
ボタンをクリック。

→
4

最初から

スクリプト全体を
もう一度実行。

↶ 操作のたびに、①へ戻る

忍者 忍者

忍者のひとこと

再実行はバグではなく、
Streamlitの基本のしくみです。

侍

侍のコツ

再実行をまたいで残す値は、
st.session_state へ。

表とグラフ

同じDataFrameを、表でも棒グラフでも表示できます。

st.dataframe(df) / 表

行売上
010
120
215

st.bar_chart(df) / 売上

app.py
import streamlit as st
import pandas as pd

df = pd.DataFrame({"売上": [10, 20, 15]})
st.dataframe(df)
st.bar_chart(df)

サイドバー

入力は左、結果はメイン画面。st.sidebar で置き場所を分けます。

表示

はなこ 5

入力した値を、ここに表示。

app.py
import streamlit as st

name = st.sidebar.text_input("なまえ")
n = st.sidebar.slider("件数", 1, 10, 5)
st.write(name, n)

演習1 / ローカルデータ

商品で表を絞り込もう

1

商品を選ぶ商品名を選んでみる。

2

表が変わるか確認「りんご」なら、
2行だけ表示。

3

「すべて」に戻す元の4行が出れば成功!

app.py / スタートコード
import streamlit as st
import pandas as pd

df = pd.DataFrame({
    "商品": ["りんご", "みかん", "ぶどう", "りんご"],
    "個数": [3, 5, 2, 8],
})
choice = st.selectbox(
    "商品", ["すべて", "りんご", "みかん", "ぶどう"])
if choice != "すべて":
    df = df[df["商品"] == choice]
st.dataframe(df)
侍

侍のコツ

絞り込みは pandas、表示は st.dataframe。
いまはPC内のデータです。Snowflakeは、まだ使いません。

PC内の表から、Snowflakeへ

ここまでは、PC内のデータ。
ここからは、Snowflakeのデータベースを読んでみます。

1

PC内のデータ

CSVやpandasの表を、
自分のPCで扱いました。

2

Snowflakeの表

1台のPCにあるファイルではなく、
データベースの表を使います。

3

SQLで取り出す

クエリで必要なデータを読み、
Streamlitの画面に表示します。

町娘

ここがポイント

変わるのは、データの読み元。
画面に出す考え方は同じです。

侍

侍のコツ

まずは「接続 → 読む → 表示」。
ひとつずつ確認しましょう。

接続から表示まで、4ステップ

設定ファイルを用意したら、接続・クエリ・表示の順に進みます。

1

接続情報を書く

.streamlit/
secrets.toml

→
2

接続する

st.connection(
"snowflake")

→
3

クエリで読む

SQLを実行して、
必要なデータを取得。

→
4

表を表示する

st.dataframe(df)

町娘

ここがポイント

画面づくりは、ここまでと同じ。
Snowflakeから読んだ結果を、st.dataframe で表示します。

接続情報は secrets.toml へ

接続情報はPythonから分けて、ローカルの設定ファイルへ。

.streamlit/secrets.toml
# 公式のキーペア認証例 / 値はすべて置き換え用
[connections.snowflake]
account = "YOUR_ORG-YOUR_ACCOUNT"
user = "YOUR_USER"
private_key_file = "YOUR_PRIVATE_KEY_FILE"
role = "YOUR_ROLE"
warehouse = "YOUR_WAREHOUSE"
database = "YOUR_DATABASE"
schema = "YOUR_SCHEMA"
侍

侍のコツ

YOUR_... は、自分の環境の値に置き換えます。
公式例はキーペア認証。認証の準備がまだなら、講師デモで確認しましょう。

Snowflakeにつないで、表を出す

公式手順で作った PETS.PUBLIC.MYTABLE を読みます。
接続設定は前のページのまま。まずは最大10行だけ。

app.py
import streamlit as st
conn = st.connection("snowflake")
df = conn.query(
    """SELECT NAME, PET
    FROM PETS.PUBLIC.MYTABLE
    LIMIT 10""")
st.dataframe(df)
侍

侍のコツ

この表は自動では入りません。
公式チュートリアルで事前作成。

忍者 忍者

忍者のひとこと

最初は LIMIT 10。
一度に大量に読まない。

値は params で、安全に渡す

SQLに値を埋め込まず、「?」に対応する値を params で渡します。

app.py
import streamlit as st
conn = st.connection(
    "snowflake", paramstyle="qmark")
pet = st.selectbox("ペット", ["dog", "cat", "bird"])
sql = """SELECT NAME, PET
FROM PETS.PUBLIC.MYTABLE
WHERE PET = ?
LIMIT 10"""
df = conn.query(sql, params=[pet])
st.dataframe(df)

ペットを選ぶ

dog▼

表示

Mary / dog
町娘

ここがポイント

SQLは固定、値だけを渡す。
params=[pet] が、
「?」に対応します。

演習2 / Snowflakeのデータ

ペットを選んで、表を見よう

1

接続を確認接続設定は、
15ページと同じ。

2

ペットを変更dog → cat → bird

3

表の変化を見るPETが一致すれば成功。

app.py / スタートコード
import streamlit as st
conn = st.connection(
    "snowflake", paramstyle="qmark")
pet = st.selectbox("ペット", ["dog", "cat", "bird"])
sql = """SELECT NAME, PET
FROM PETS.PUBLIC.MYTABLE
WHERE PET = ?
LIMIT 10"""
df = conn.query(sql, params=[pet])
st.dataframe(df)
侍

侍のコツ

前提:公式手順で PETS.PUBLIC.MYTABLE を作成済み。
アカウントや認証の準備がまだなら、講師デモで流れを確認しましょう。

気をつけたいこと

困ったら、この4つを順番に確認しましょう。

忍者

認証・接続情報

secrets.toml の値と、
秘密鍵の場所・アカウント識別子。
まずは接続設定を見直そう。

忍者

ウェアハウス

停止・再開設定と負荷を確認。
小さいサイズで重いSQLは避ける。
演習は X-Small +短い自動停止。

忍者

上から下へ、再実行

未キャッシュならSQLも繰り返す。
conn.query は結果をキャッシュ。
再実行とキャッシュを分けて考える。

忍者

値は params で渡す

SQL文字列に値を埋め込まない。
固定SQLの「?」に対し、
params=[pet] で値を渡す。

ふりかえり

画面づくりから、Snowflakeのデータ表示まで。一歩ずつつながりました。

きょうやったこと

1

Streamlitの基本文章・ウィジェット・再実行

2

表とグラフDataFrameを、見える形に

3

サイドバー操作と表示を分ける

4

Snowflakeと連携接続 → クエリ → 安全に絞り込み

次の一歩

st.cache_data

重い処理やデータ取得の
結果を再利用する。

Streamlit Community Cloud

アプリの公開に挑戦する。
公開は任意。きょうはローカルでOK。

Streamlit in Snowflake

Snowflake内でアプリを作り、
実行・共有する。

Q&A

ありがとう!

質問・つまずいたところをどうぞ。

古川 格 / HAGAKURE PROGRAMMING塾

侍
侍ガイド・コツ
忍者
忍者舞台裏
忍者
忍者落とし穴
町娘
町娘ここがポイント