2024年の Snowflake Python APIs リリースノート¶

新機能および更新¶

• スタックトレースを短縮してエラーメッセージを改善しました。この動作を制御するには、 _SNOWFLAKE_PRINT_VERBOSE_STACK_TRACE 環境変数オプションを使用します。

• モデルから to_dict() によって返されるディクショナリに、読み取り専用のプロパティがデフォルトで含まれるようになりました。このオプションを切り替えるには、 to_dict (hide_readonly_properties=True) を使用します。

• 以下のメソッドとリソースに指定されたリソースが存在しない場合に、エラーにならずにアクションを実行できるかどうかを切り替える、 if_exists プロパティを追加しました。

  • Database、 NetworkPolicy、 View、 User、 ComputePool、 ImageRepository、 Pipe、 Role、 Service、 Stage、 Table、 Task、 DynamicTable、 Role、 Alert、 Procedure、 Warehouse、 Schema、および Function の drop()。

  • Database、および DynamicTable の refresh()。

  • Service、 DynamicTable、および Warehouse の suspend() および resume()。

  • DynamicTable、および Table の suspendRecluster() および resumeRecluster()。

• Database は、 undrop() メソッドをサポートするようになりました。

• Service は、 iter() で from_name パラメーターをサポートするようになりました。

• Table は、 swap_with() で target_database と target_schema パラメーターをサポートするようになりました。

• Procedure は、 create() で copy_grants パラメーターをサポートするようになりました。

バグ修正¶

• ダイナミックテーブルの作成で、異なるデータベースやスキーマからソースオブジェクトをクローニングできるようになりました。

• ホスト名にアンダースコアを使用したアカウントおよび組織で、 SSL 接続にあった問題を修正しました。

新機能および更新¶

• データベースロールリソースのサポートを追加しました。

• ロール、データベースロール、およびユーザーリソースに、アクセス権限を管理するための新しいメソッドを追加しました。

• シークレットをスクラブしてログを改善しました。

バグ修正¶

• なし。

新機能および更新¶

• API ドキュメントを大幅に改善しました。

• snowflake.core の依存関係としての snowflake-snowpark-python を削除しました。ただし、タスクグラフ（DAG）の概念など、一部の機能にはこのパッケージが引き続き必要です。これらの機能のチェックとリクエストは実行時に行われます。

• Pythonバージョン3.8以降のすべてにサポートを追加しました。

• テーブルをクローニングするための targetDatabase と targetSchema のサポートを追加しました。

• スキーマをクローニングするための targetDatabase のサポートを追加しました。

• 型定義が表示されるようになりました。

• ServiceCollection での execute_job のサポートを追加しました。

• ServiceResource での get_containers、 get_instances、および get_roles のサポートを追加しました。

• Service および ComputePool での create_or_update のサポートを追加しました。

• 以下の新しいリソースのサポートを追加しました。

  • アカウント

  • アラート

  • カタログ統合

  • イベントテーブル

  • 外部ボリューム

  • 管理アカウント

  • ネットワークポリシー

  • ノートブック

  • 通知の統合

  • パイプ

  • プロシージャ

  • ストリーム

  • ユーザー定義関数

  • ビュー

バグ修正¶

• URL のすべての文字列がログに注入されないという、 URLs のログに関するバグを修正しました。

新機能および更新¶

• なし。

バグ修正¶

• 大型の結果の処理に関する複数の問題を修正しました。

新機能および更新¶

• クライアントは再試行可能なエラーコードのリクエストを再試行するようになりました。

• 以下の StageResource メソッドは廃止され、名前が変更されました。古いメソッド名はエイリアスになりました。

  • upload_file から put に。

  • download_file から get に。

新機能および更新¶

• デバッグ機能を強化するため、ライブラリにクライアントログを追加しました。

• DynamicTable、 Schema、および Table オブジェクト型に undrop サポートを追加しました。

• Grant オブジェクト型のサポートを強化しました。以下の制限があります。

  • SQL コマンド SHOW GRANTS ON はサポートされていません。

  • Grants.to メソッド（SHOW GRANTS TO）の付与者の値としてサポートされているのは Grantees.role のみです。

• 同等の SQL コマンドとの整合性を高めるため、以下のメソッドは廃止され、以下のように名前が変更されました。古いメソッド名は新しいメソッド名を呼び出すエイリアスになっているため、古いメソッド名は期待通りに機能します。

  • create_or_update から create_or_alter に。

  • delete から drop に。

  • undelete から undrop に。

バグ修正¶

• ストアドプロシージャ生成コードのバグを修正しました。

新機能および更新¶

• 以下のリソースの API サポートを追加しました。

  • DynamicTable

  • Function （現在はサービス関数のみサポート）

  • Grant

• タスクとタスクグラフ（DAGs）でファイナライザーのサポートを追加しました。

新機能および更新¶

• 以下のリソース用に、 試験 モードでの API サポートを追加しました。

  • User

  • Role

  • 管理 Stage

• Warehouse、 Schema、および Database リソースの create_or_update サポートを再追加しました。

  注釈

  これらのリソースの create_or_update 機能には、近日リリース予定のSnowflakeバージョン8.23が必要です。このバージョンは、2024年6月10日現在、リリースされていません。

• 特定の Service オブジェクトのエンドポイントのリストを返す Service リソース用の get_endpoints メソッドを追加しました。

バグ修正¶

• with_managed_access が SchemaResource のプロパティとして正しく返されるようになりました。

新機能および更新¶

• create_or_update に SchemaResource 用の with_managed_access ブール値オプションを追加しました。このオプションは、 CREATE SCHEMA の WITH MANAGED ACCESS オプションパラメーターと同等です。

  • 使用例:

    schema.create_or_update(schema_def, with_managed_access = True)
    

    Copy

• 特定の Service オブジェクトのエンドポイントのリストを返す Service リソース用の get_endpoints メソッドを追加しました。

動作の変更¶

• TableResource オブジェクトの fetch() から deep パラメーターを削除しました。 fetch() は常に TableResource の詳細な列と制約情報を返します。

• create_or_update() は、現在、 Schema、 Warehouse、 Database、 ComputePool リソースでは動作しません。 create() はこれらのリソースで動作します。

• as_select を使用してテーブルを作成しても、 as_select クエリで使用されているソーステーブルの情報が引き継がれなくなりました。

• テーブルの data_retention_time_in_days および max_data_extension_time_in_days プロパティは、既存のテーブルを変更する create_or_update ステートメントで明示的に設定されていない場合、スキーマまたはデータベース設定から継承されます。

新機能および更新¶

• Cortex Search API エンドポイントのサポートを追加しました。

• より大きな結果のサポートを追加しました。

• 長時間クエリのサポートを追加しました。

• Service リソースに、指定された文字列から仕様タイプを推測する ServiceSpec ヘルパー関数を追加しました。

• すべてのリソースについてSnowflake APIREST プラットフォームを使用するように更新されました。

• pip install snowflake[ml] で snowflake-ml-python v1.4.0がインストールされます。

バグ修正¶

• さまざまなバグ修正を行いました。

新機能および更新¶

snowflake パッケージの更新:

• pip install snowflake[ml] を実行して、 Snowpark ML ライブラリを追加パッケージ依存関係としてインストールできるようになりました。

snowflake.core パッケージの更新:

• タスクの前任者が完全修飾名を返すようになりました。

• DAGRun に __str__() および __repr_html__() メソッドを追加し、ノートブックと互換性を持たせました。

• Snowflakeドキュメンテーションとの整合性を高めるため、 API リファレンスドキュメンテーションの「DAGs」を「タスクグラフ」に置き換えました。

バグ修正¶

snowflake.core パッケージの修正:

• コードジェネレーターを修正し、 OpenAPI 仕様駆動モデルを更新しました。

• Pydanticとの互換性の問題を修正しました。

• Task.error_integration プロパティのバグを修正しました。

• REST プロパティがない場合の Task.config プロパティのバグを修正しました。

新機能および更新¶

• DAGTask の >> と << 演算子が、関数を直接受け取るようになりました。

• DAGTask は、デフォルトで DAG のウェアハウスを使用するようになりました。

• DAGTask は、新しいパラメーター session_parameters を受け取ります。

• TaskContext を更新しました。

  • メソッド get_predecessor_return_value は、 DAGTask の長い名前でも短い名前でも動作するようになりました。

  • メソッド get_current_task_short_name と get_task_graph_config_property を追加しました。

• Pydantic 2.xのサポートを追加しました。

• Python 3.11のサポートを追加しました。

バグ修正¶

• DAG にスケジュールがない場合に DAGOperation.run() が例外が発生するバグを修正しました。

• DAG を削除してもそのサブタスクがすべて削除されないバグを修正しました。

• DAG の config が設定されたときにエラーが発生するバグを修正しました。