Python UDF の制限¶
このトピックでは、Pythonで記述されたハンドラーの制限事項について説明します。
このトピックの内容:
一般的な制限¶
Python関数では標準Pythonパッケージのモジュールと関数を使用できますが、Snowflakeのセキュリティ制約により、ファイルへの書き込みといった一部の機能が無効になります。詳細については、 優れたセキュリティプラクティスに準拠 というタイトルのセクションをご参照ください。
ステージを通じて持ち込まれるすべてのUDFsおよびモジュールは、プラットフォームに依存しない必要があり、ネイティブ拡張を含めることはできません。
特定の CPU アーキテクチャ（例: x86）を想定したコードは避けます。
特定のオペレーティングシステムを想定したコードは避けます。
Python UDFsは共有できません。Python UDFsを使用するデータベースオブジェクトも共有できません。たとえば、次は実行できません。
Python UDFを直接共有する。
Python UDF を呼び出すビューを共有する。
Python UDFを呼び出す関数を共有する。
Python UDFを呼び出すマスキングまたは行アクセスポリシーを使用してテーブルを共有する。
Python UDFで USAGE権限を付与すると、受信者はそのUDFによってインポートされたファイルの内容を表示できる場合があります。Python UDFに対するUSAGE権限をロールに付与し、そのロールがそのPython UDFを呼び出すステートメントを実行する場合、同じステートメント内の任意のPython UDFは、USAGE権限を付与されたPython UDFによってインポートされた任意のファイルの内容を読み取ることができます。
データベース複製はインラインPython UDFs でサポートされています。ただし、Python UDF がステージ内のファイル（つまり、 IMPORTS 句を使用して作成された関数）に依存している場合、複製はブロックされます。この制限は、将来のバージョンで削除される可能性があります。
SnowflakeはPython
zipimportモジュールを使用して、ステージからPythonコードをインポートします。その結果、zipimportの制限もUDFsに存在します。zipimportの詳細については、 zipimportリファレンス をご参照ください。
クローニングの制限¶
Python UDFは、Python UDFを含むデータベースまたはスキーマがクローンされるときに、クローンできます。クローンを作成するには、Python UDFが次の条件を満たす必要があります。
Python UDFがステージを参照する場合、そのステージは、クローンされるスキーマ（またはデータベース）の 外部 にある必要があります。
次の方法で、Python UDFと参照ステージを別々のスキーマ（および/または別々のデータベース）に保持できます。
Python UDFがステージを参照する場合は常に、Python UDFのスキーマまたはデータベースとは異なる修飾ステージ名（例: 「my_db.my_schema.my_stage()」）を使用します。クローン作成操作でデータベースのクローンを作成する場合、ステージ参照にはデータベースとスキーマを含める必要があります。クローン作成操作でスキーマのクローンを作成する場合、ステージ参照にはスキーマ（およびオプションでデータベース）を含める必要があります。
非修飾ステージ名（現在のセッションのアクティブなデータベースとスキーマを暗黙的に使用する）を使用して参照されるステージを作成し、セッションの現在のデータベースとスキーマと一致しない修飾名を使用してPython UDFを作成します。
ユーザーのステージを参照されるステージとして使用します（ユーザーのステージは、データベースのステージまたはスキーマのステージとは別のものです）。
スキーマまたはデータベース内の1つ以上のPython UDFsが必要な条件を満たしていない場合でも、スキーマまたはデータベースのクローンを作成できますが、非準拠のPython UDFsは、エラーまたは警告メッセージなしでクローンから省略されます。
クローンされた各Python UDFは、元のPythonと同じ定義を持っています。その定義には、ステージへの参照が含まれます。Python UDFのステージ参照は完全修飾されている必要があるため、クローンを作成するスキーマやデータベースに相対するものではなく、絶対的なものです。オリジナルとクローンの両方が同じステージとファイルをポイントしているため、
ステージをドロップするか、ステージから必要なファイルを削除すると、元とクローンされた UDF の両方が無効になります。
ステージまたはステージ上のファイルを変更すると、元とクローンされたUDFの両方に影響します。