ここがポイント
きょうの到達点は、
データを画面に出すこと。
90分のハンズオン
基本からSnowflake連携まで
きょう作るもの
Snowflakeのテーブルを、
Streamlitアプリの画面に。
完成イメージ / 架空データ
Snowflakeのテーブル表示
| 項目 | 件数 |
|---|---|
| データ A | 120 |
| データ B | 85 |
HAGAKURE PROGRAMMING塾
「自分のPCで、データが見えた!」まで進みましょう。
できるようになること
自分のPCで、Snowflakeのデータを
Streamlitの画面に表示できる。
きょうの到達点は、
データを画面に出すこと。
まずは小さく動かして、
一歩ずつつなげましょう。
Python環境は準備済み。その環境に、必要なライブラリを入れます。
Python環境(venv / pip)環境構築はできている前提で進めます。
事前にインストールpip install streamlit snowflake-snowpark-python
Snowflakeアカウントメールアドレスで無料トライアルを作成。クレジットカードは不要です。
無料トライアルは30日間申込ページでは $400 分の無料クレジットを案内しています。
アカウントがまだなくても大丈夫。
後半は講師デモを見ながら、流れをつかみましょう。
前半は画面づくり、後半はSnowflake。90分でつないでいきます。
侍のコツ:アカウントがまだない方は、後半は講師デモで流れをつかみましょう。
Pythonスクリプトを、ブラウザで使えるWebアプリに。
Streamlitは、オープンソースのPythonライブラリです。
いつものPythonで、
表示したい内容を書きます。
スクリプトから、
Webアプリの画面をつくります。
できた画面を、
ブラウザで見て、操作します。
HTML・CSS・JavaScriptを
自分で書かなくてもOK。
まずは、タイトルと文章だけ。
次のページで動かしてみましょう。
下のコードを app.py に保存。
ターミナルで起動して、ブラウザの画面を見てみましょう。
import streamlit as st st.title("はじめての Streamlit") st.write("Pythonが、そのままWebアプリになる。")
ターミナルで実行:streamlit run app.py
app.py を保存してから、
同じフォルダで起動しましょう。
見出し・文章・装飾。まずは、この3つを使い分けましょう。
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
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)
ウィジェットを操作すると、スクリプト全体が最初から再実行されます。
Pythonを
上から下へ実行。
実行結果が
画面に表示される。
入力・選択・
ボタンをクリック。
スクリプト全体を
もう一度実行。
↶ 操作のたびに、①へ戻る
再実行はバグではなく、
Streamlitの基本のしくみです。
再実行をまたいで残す値は、
st.session_state へ。
同じDataFrameを、表でも棒グラフでも表示できます。
st.dataframe(df) / 表
| 行 | 売上 |
|---|---|
| 0 | 10 |
| 1 | 20 |
| 2 | 15 |
st.bar_chart(df) / 売上
import streamlit as st import pandas as pd df = pd.DataFrame({"売上": [10, 20, 15]}) st.dataframe(df) st.bar_chart(df)
入力は左、結果はメイン画面。st.sidebar で置き場所を分けます。
入力した値を、ここに表示。
import streamlit as st name = st.sidebar.text_input("なまえ") n = st.sidebar.slider("件数", 1, 10, 5) st.write(name, n)
演習1 / ローカルデータ
商品を選ぶ商品名を選んでみる。
表が変わるか確認「りんご」なら、
2行だけ表示。
「すべて」に戻す元の4行が出れば成功!
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のデータベースを読んでみます。
CSVやpandasの表を、
自分のPCで扱いました。
1台のPCにあるファイルではなく、
データベースの表を使います。
クエリで必要なデータを読み、
Streamlitの画面に表示します。
変わるのは、データの読み元。
画面に出す考え方は同じです。
まずは「接続 → 読む → 表示」。
ひとつずつ確認しましょう。
設定ファイルを用意したら、接続・クエリ・表示の順に進みます。
.streamlit/
secrets.toml
st.connection(
"snowflake")
SQLを実行して、
必要なデータを取得。
st.dataframe(df)
画面づくりは、ここまでと同じ。
Snowflakeから読んだ結果を、st.dataframe で表示します。
接続情報はPythonから分けて、ローカルの設定ファイルへ。
# 公式のキーペア認証例 / 値はすべて置き換え用 [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_... は、自分の環境の値に置き換えます。
公式例はキーペア認証。認証の準備がまだなら、講師デモで確認しましょう。
公式手順で作った PETS.PUBLIC.MYTABLE を読みます。
接続設定は前のページのまま。まずは最大10行だけ。
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。
一度に大量に読まない。
SQLに値を埋め込まず、「?」に対応する値を params で渡します。
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)
ペットを選ぶ
表示
SQLは固定、値だけを渡す。
params=[pet] が、
「?」に対応します。
演習2 / Snowflakeのデータ
接続を確認接続設定は、
15ページと同じ。
ペットを変更dog → cat → bird
表の変化を見るPETが一致すれば成功。
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 は結果をキャッシュ。
再実行とキャッシュを分けて考える。
SQL文字列に値を埋め込まない。
固定SQLの「?」に対し、
params=[pet] で値を渡す。
画面づくりから、Snowflakeのデータ表示まで。一歩ずつつながりました。
きょうやったこと
Streamlitの基本文章・ウィジェット・再実行
表とグラフDataFrameを、見える形に
サイドバー操作と表示を分ける
Snowflakeと連携接続 → クエリ → 安全に絞り込み
次の一歩
重い処理やデータ取得の
結果を再利用する。
アプリの公開に挑戦する。
公開は任意。きょうはローカルでOK。
Snowflake内でアプリを作り、
実行・共有する。
Q&A
質問・つまずいたところをどうぞ。
古川 格 / HAGAKURE PROGRAMMING塾