Snowflake Notebooks でのエラーのトラブルシューティング¶

Snowsight のノートブックの総数が、以下の制限を超えています。¶

アカウント内のノートブックの総数が6000を超え、Notebooksを更新すると、以下のエラーが発生します。

Result size for streamlit list exceeded the limit. Streamlit list was truncated.

ユーザーは引き続き新しいノートブックを作成できますが、Snowflakeではアカウントで使用しなくなったノートブックを削除することを推奨しています。

パッケージ更新時のNotebooks (ウェアハウスランタイム) エラー¶

Snowflakeでは、サポートされなくなった古い snowflake-ml パッケージを廃止しました。パッケージセレクターから削除され、Snowflake Anacondaチャンネルで利用することはできません。snowflake-ml を使用しており、ノートブックのパッケージを追加、削除、更新しようとすると、 snowflake-ml にはすでにアクセスできないため、これらのノートブックは失敗します。

問題を回避するには、Snowflake ML の正しいパッケージである snowflake-ml-python に切り替えてください。

プロトリーエラー¶

st.plotly_chart(fig, render_mode='svg')

WebGL is not supported by your browser - visit https://get.webgl.org for more info.

データポイントが1,000を超えると、Plotlyはwebglに切り替えます。

AttributeError: NoneType¶

ノートブックの既存の変数と同じ名前にセル名を変更すると、以下のエラーが発生します。

AttributeError: ‘NoneType’ object has no attribute ‘sql’

たとえば、 cell1 というPythonのセルに以下があるとします。

session = get_active_session() #establishing a Snowpark session

その後、 cell2 の名前を「session」に変更し、 cell3 で「session」を参照すると、 NotebooksはSnowparkのセッションではなく、「session」（セル名）を参照しようとしてエラーになります。

早期切断¶

ノートブックセッションはストアドプロシージャとして実行されます。タイムアウトはウェアハウスランタイムでは30分、Container Runtimeでは60分です。タイムアウト前にノートブックが予期せず切断された場合、 ACCOUNTADMIN またはウェアハウスのオーナーが STATEMENT_TIMEOUT_IN_SECONDS パラメーターを特定の値（例えば5分）にセットしている可能性があります。これは、ノートブックセッションを含むウェアハウス上ですべてのステートメントを実行できる時間を制限するものです。このパラメーターはウェアハウスまたはアカウントレベルで設定され、ウェアハウスとセッションの両方で設定された場合、ゼロでない最も小さい値が強制されます。

ノートブックをより長く実行するには、デフォルトのウェアハウス SYSTEM$STREAMLIT_NOTEBOOK$WAREHOUSE を使うか、 STATEMENT_TIMEOUT_IN_SECONDS パラメーターをより長い時間に変更します。

アイドル時間設定の詳細については、 アイドルタイムと再接続 をご参照ください。

再接続の失敗¶

ブラウザでCookieを有効にしていない場合、Notebooksセッションがまだアクティブである間（アクティビティがないためにタイムアウトする前）、自動的に再接続することはできません。ノートブックを再度開くと、エラーメッセージが表示されます。

Notebook connection lost and cannot reconnect. Restart or end session.

セッションを再起動すると、現在の EXECUTE NOTEBOOK クエリが終了し、新しいセッションが開始されます。セッションを終了すると、現在の EXECUTE NOTEBOOK クエリが終了します。

Query History どちらのアクションも行わなかった場合、現在の EXECUTE NOTEBOOK クエリはウェアハウス上で実行され続けます。

ファイアウォールにより接続できません¶

ノートブックを起動しようとすると、次のようなポップアップが表示されます。

Something went wrong. Unable to connect. A firewall or ad blocker might be preventing you from connecting.

Ensure that *.snowflake.app and *.snowflake.com are on the allowlist in your network (including content filtering systems), and can connect to Snowflake. For Streamlit apps using container runtimes, also add *.snowflakecomputing.app to the allowlist. When these domains are on the allowlist, your apps can communicate with Snowflake servers without any restrictions. However, in some cases adding these domains may not be sufficient due to network policies blocking subpaths under them. If this occurs, contact your network administrator.

さらに、Snowflakeバックエンドへの接続に問題が発生しないように、ネットワーク構成で WebSockets がブロックされていないことを確認してください。

欠落しているパッケージ¶

ノートブック環境にインストールされていないパッケージを使用しようとしている場合、セル出力に以下のメッセージが表示されます。

ModuleNotFoundError: Line 2: Module Not Found: snowflake.core. To import packages from Anaconda, install them first using the package
selector at the top of the page.

ノートブックで使用するPythonパッケージをインポートする ページの指示に従って、必要なパッケージをインポートします。

SnowflakeInternalException{signature=std::vector<sf::RuntimePathLinkage> sf::{anonymous}::buildRuntimeFileSet(const sf::UdfRuntime&, std::string_view, const std::vector<sf::udf::ThirdPartyLibrariesInfo>&, bool):"libpython_missing", internalMsg=[XP_WORKER_FAILURE: Unexpected error signaled by function 'std::vector<sf::RuntimePathLinkage> sf::{anonymous}::buildRuntimeFileSet(const sf::UdfRuntime&, std::string_view, const std::vector<sf::udf::ThirdPartyLibrariesInfo>&, bool)'
Assert "libpython_missing"[{"function": "std::vector<sf::RuntimePathLinkage> sf::{anonymous}::buildRuntimeFileSet(const sf::UdfRuntime&, std::string_view, const std::vector<sf::udf::ThirdPartyLibrariesInfo>&, bool)", "line": 1307, "stack frame ptr": "0xf2ff65553120",  "libPythonOnHost": "/opt/sfc/deployments/prod1/ExecPlatform/cache/directory_cache/server_2921757878/v3/python_udf_libs/.data/4e8f2a35e2a60eb4cce3538d6f794bd7881d238d64b1b3e28c72c0f3d58843f0/lib/libpython3.9.so.1.0"}]], userMsg=Processing aborted due to error 300010:791225565; incident 9770775., reporter=unknown, dumpFile= file://, isAborting=true, isVerbose=false}

ノートブックがありません¶

ノートブックはスキーマレベルのオブジェクトであり、データベースの特定のスキーマ内に格納されています。スキーマがドロップ（削除）されると、そのスキーマに含まれるすべてのオブジェクト（ノートブックを含む）も削除されます。以前に存在していたノートブックが表示されない場合は、そのノートブックが属するスキーマがドロップされた可能性があります。この場合、ノートブックは完全に削除され、復元はできません。

誤ってノートブックを紛失しないようにするには：

• スキーマを削除する前に、スキーマに含まれるオブジェクトを確認します。

• 偶発的または不正な削除を避けるために、スキーマ削除権限を制限します。

• ノートブック外のバージョン管理スクリプトでノートブック内容をエクスポートすることを検討してください。

ノートブックが欠落していてスキーマがまだ存在する場合、現在のロールがスキーマとそのオブジェクトを表示するために必要な権限を持っていることを確認してください。

読み取り専用ファイルシステムの問題¶

Pythonライブラリの中には、データをローカルユーザディレクトリにダウンロードしたりキャッシュしたりするものがあります。ただし、デフォルトのユーザーディレクトリ /home/udf は読み取り専用です。これを回避するには、パスを書き込み可能な場所である /tmp に設定します。書き込みディレクトリの設定に使用する環境変数は、使用するライブラリによって異なる場合があることに注意してください。以下は、この問題が発生する既知のライブラリのリストです。

• matplotlib

• HuggingFace

• catboost

Matplotlib created a temporary cache directory at /tmp/matplotlib-2fk8582w because the default path (/home/udf/.config/matplotlib) is
not a writable directory; it is highly recommended to set the MPLCONFIGDIR environment variable to a writable directory, in particular
to speed up the import of Matplotlib and to better support multiprocessing.

import os
os.environ["MPLCONFIGDIR"] = '/tmp/'
import matplotlib.pyplot as plt

Readonly file system: `/home/udf/.cache`

import os
os.environ['HF_HOME'] = '/tmp'
os.environ['SENTENCE_TRANSFORMERS_HOME'] = '/tmp'

from sentence_transformers import SentenceTransformer
model = SentenceTransformer("Snowflake/snowflake-arctic-embed-xs")

df.collect() を使用する際の出力メッセージが大きすぎます。¶

df.collect() を実行すると、セル出力に以下のメッセージが表示されます。

MessageSizeError: Data of size 522.0 MB exceeds the message size limit of 200.0 MB.
This is often caused by a large chart or dataframe. Please decrease the amount of data sent to the browser,
or increase the limit by setting the config option server.maxMessageSize.
Click here to learn more about config options.
Note that increasing the limit may lead to long loading times and large memory consumption of the client's browser and the Streamlit server.

Snowflake Notebooks 以下のような大規模なデータセットの場合、セル出力の結果は自動的に切り捨てられます。

• すべてのSQLセル結果。

• snowpark.Dataframe の場合のPythonセル結果。

上のセルの問題は、 df.collect() が snowpark.Dataframe ではなく List を返すことです。リストは自動的に切り捨てられません。この問題を回避するには、 DataFrame の結果を直接出力します。

df

Snowpark DataFrames 上で df.to_pandas() を使用すると、ノートブックがクラッシュします。¶

df.to_pandas() を実行すると、すべてのデータがメモリにロードされるため、データサイズが関連付けられたNotebookウェアハウスのメモリ制限を超えると、Notebookセッションが終了することがあります。

data = session.table("BIG_TABLE")
df = data.to_pandas() # This may lead to memory error

# Import Snowpark pandas
import modin.pandas as pd
import snowflake.snowpark.modin.plugin
# Create a Snowpark pandas DataFrame from BIG_TABLE
df = pd.read_snowflake("BIG_TABLE")
# Keep working with your data using the pandas API
df.dropna()

SELECT * from BIG_TABLE

df = cell1.to_pandas() # This may lead to memory error

SELECT * from BIG_TABLE
snowpark_df = cell1.to_df()
df = snowpark_df.to_snowpark_pandas()
# Keep working with your data using the Snowpark pandas API

VPN 分割トンネリングが原因で接続できません。¶

VPN がスプリットトンネリングを使用するように構成されている場合、 *.snowflake.com と *.snowflake.app の両方をネットワークポリシーの allowlist に追加する必要があります。

ノートブックが存在しませんエラー¶

名前に特殊文字が含まれているノートブックを実行しようとすると、セル出力に以下のメッセージが表示されます。

Notebook <name> does not exist or not authorized

ノートブック名はSnowflake識別子です。ドットやスペースなどの特殊文字を含むノートブック名は、識別子ルールを満たすために二重引用符で囲む必要があります。

パッケージバージョンの衝突¶

ベースイメージからパッケージバージョンをロードする非対話型ノートブックを実行し、新しいバージョンをインストールしようとすると、新しいバージョンはロードされません。パッケージのバージョンがベースイメージと一致していることを確認してください。インタラクティブなノートブックでは、新しいバージョンを使うためにノートブックを再起動するよう促されます。

SPCS スケジュールノートブックが実行できません。¶

Container Runtimeでスケジュールノートブックを実行する前に、イメージリポジトリを作成する必要があります。画像リポジトリがない場合、以下のエラーが表示されます。

Failed to retrieve image.

画像リポジトリの作成方法の詳細については、 CREATE IMAGE REPOSITORY を参照してください。

ログメッセージの出力失敗¶

ログメッセージがノートブックの出力に表示されない場合は、ログが stdout に向けられます。以下は、ログを正しく構成する方法の例です。

import logging
import sys

# Create a logger
logger = logging.getLogger()

# Set the log level
logger.setLevel(logging.DEBUG)

# Create a stream handler that writes to sys.stdout
stdout_handler = logging.StreamHandler(sys.stdout)

# Set the log format (optional)
formatter = logging.Formatter('%(levelname)s: %(message)s')
stdout_handler.setFormatter(formatter)

# Add the handler to the logger
logger.addHandler(stdout_handler)

# Test the logging output
logger.warning("This is a warning message.")

エラーを強調表示するには、同様の方法で stderr に送信できます。また、Snowflake NotebooksでStreamlitを使用している場合は、Streamlitの組み込み関数を使用して形式を明確にすることもできます。

import streamlit as st st.warning("This is a warning message.")
st.write("This is a normal message.")
st.error("This is an error message.")

ノートブック実行不能¶

CREATE NOTEBOOK を使ってノートブックを作成した場合、バージョンステージでノートブックが自動的にライブバージョンを持つことはありません。ライブバージョンをセットせずに EXECUTE NOTEBOOK を使ってノートブックを実行しようとした場合、またはノートブックを作成した後でそのノートブックが削除された場合、次のエラーが発生します。

Live version is not found.

このエラーを解決するには、以下のコマンドを使用して初期ライブバージョンをセットします。

ALTER NOTEBOOK <name> ADD LIVE VERSION FROM LAST;