Java UDF の制限事項¶

一般的な制限¶

• Javaメソッドは標準のJavaライブラリのクラスとメソッドを使用できますが、Snowflakeのセキュリティ制約により、ファイルへの書き込みなど、一部の機能が無効になります。詳細については、 優れたセキュリティプラクティスに準拠 というタイトルのセクションをご参照ください。

• Java UDFs は共有できません。Java UDFs を使用するデータベースオブジェクトも共有できません。たとえば、次は実行できません。

  • Java UDF を直接共有する。

  • Java UDF を呼び出すビューを共有する。

  • Java UDF を呼び出す関数を共有する。

  • Java UDF を呼び出すマスキングまたは行アクセスポリシーを使用してテーブルを共有する。

• Java UDF で USAGE 権限を付与すると、受信者はその UDF によってインポートされたファイルの内容を表示できる場合があります。Java UDF に対する USAGE 権限をロールに付与し、そのロールがそのJava UDF を呼び出すステートメントを実行する場合、同じステートメント内の任意のJava UDF は、USAGE 権限を付与されたJava UDF によってインポートされた任意のファイルの内容を読み取ることができます。

• 複製 には、外部ステージまたは内部ステージはまだ含まれていません。セカンダリデータベースをプライマリデータベースとして機能するように昇格する場合は、ステージオブジェクトを再作成し、内部ステージに欠落しているファイルを再インポートする必要があります。ファイルには、元のプライマリデータベースと同じパスとファイル名が必要です。

• Java UDF 出力行の最大サイズは16 MB です。

クローニングの制限¶

Java UDF は、Java UDF を含むデータベースまたはスキーマがクローンされるときに、クローンできます。クローンを作成するには、Java UDF が次の条件を満たす必要があります。

• Java UDF がステージ（例: UDF の JAR ファイルを含むステージ）を参照する場合、そのステージは、クローンされるスキーマ（またはデータベース）の 外部 である必要があります。

  次の方法で、Java UDF と参照ステージを別々のスキーマ（および/または別々のデータベース）に保持できます。

  • Java UDF がステージを参照する場合は常に、Java UDF のスキーマまたはデータベースとは異なる修飾ステージ名（例: 「my_db.my_schema.my_stage()」）を使用します。クローン作成操作でデータベースのクローンを作成する場合、ステージ参照にはデータベースとスキーマを含める必要があります。クローン作成操作でスキーマのクローンを作成する場合、ステージ参照にはスキーマ（およびオプションでデータベース）を含める必要があります。

  • 非修飾ステージ名（現在のセッションのアクティブなデータベースとスキーマを暗黙的に使用する）を使用して参照されるステージを作成し、セッションの現在のデータベースとスキーマと一致しない修飾名を使用してJava UDF を作成します。

  • ユーザーのステージを参照されるステージとして使用します（ユーザーのステージは、データベースのステージまたはスキーマのステージとは別のものです）。

スキーマまたはデータベース内の1つ以上のJava UDFs が必要な条件を満たしていない場合でも、スキーマまたはデータベースのクローンを作成できますが、非準拠のJava UDFs は、エラーまたは警告メッセージなしでクローンから省略されます。

クローンされた各Java UDF は、元のJavaと同じ定義を持っています。その定義には、ステージへの参照が含まれます。Java UDF のステージ参照は完全修飾されている必要があるため、クローンを作成するスキーマやデータベースに関連するものではなく、絶対的なものです。オリジナルとクローンの両方が同じステージとファイルをポイントしているため、

• ステージをドロップするか、ステージから必要なファイルを削除すると、元とクローンされた UDF の両方が無効になります。

• ステージまたはステージ上のファイルを変更すると（例: JAR ファイルを新しい JAR ファイルに置き換える）、元とクローンされた UDF の両方に影響します。

クローン作成の詳細については、 クローニングに関する考慮事項 をご参照ください。