snowflake-snowpark-python 1.55.1__tar.gz → 1.55.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (248) hide show
  1. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/CHANGELOG.md +12 -0
  2. {snowflake_snowpark_python-1.55.1/src/snowflake_snowpark_python.egg-info → snowflake_snowpark_python-1.55.2}/PKG-INFO +2 -2
  3. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/setup.py +1 -1
  4. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/dataframe.py +66 -3
  5. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/dataframe_reader.py +20 -0
  6. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/dataframe_stat_functions.py +9 -1
  7. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/dataframe_writer.py +3 -2
  8. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/exceptions.py +17 -0
  9. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/file_operation.py +29 -1
  10. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/files.py +13 -1
  11. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/functions.py +58 -26
  12. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/extensions/pd_extensions.py +35 -0
  13. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/session.py +131 -1
  14. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/table.py +15 -1
  15. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/version.py +1 -1
  16. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2/src/snowflake_snowpark_python.egg-info}/PKG-INFO +2 -2
  17. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake_snowpark_python.egg-info/requires.txt +1 -1
  18. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/LICENSE.txt +0 -0
  19. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/MANIFEST.in +0 -0
  20. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/README.md +0 -0
  21. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/pyproject.toml +0 -0
  22. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/setup.cfg +0 -0
  23. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/__init__.py +0 -0
  24. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_functions/__init__.py +0 -0
  25. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_functions/general_functions.py +0 -0
  26. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_functions/scalar_functions.py +0 -0
  27. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/__init__.py +0 -0
  28. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/analyzer/__init__.py +0 -0
  29. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/analyzer/analyzer.py +0 -0
  30. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/analyzer/analyzer_utils.py +0 -0
  31. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/analyzer/binary_expression.py +0 -0
  32. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/analyzer/binary_plan_node.py +0 -0
  33. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/analyzer/datatype_mapper.py +0 -0
  34. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/analyzer/expression.py +0 -0
  35. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/analyzer/grouping_set.py +0 -0
  36. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/analyzer/metadata_utils.py +0 -0
  37. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/analyzer/query_plan_analysis_utils.py +0 -0
  38. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/analyzer/schema_utils.py +0 -0
  39. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/analyzer/select_statement.py +0 -0
  40. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/analyzer/snowflake_plan.py +0 -0
  41. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/analyzer/snowflake_plan_node.py +0 -0
  42. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/analyzer/sort_expression.py +0 -0
  43. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/analyzer/table_function.py +0 -0
  44. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/analyzer/table_merge_expression.py +0 -0
  45. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/analyzer/unary_expression.py +0 -0
  46. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/analyzer/unary_plan_node.py +0 -0
  47. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/analyzer/window_expression.py +0 -0
  48. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/ast/__init__.py +0 -0
  49. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/ast/batch.py +0 -0
  50. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/ast/builder.py +0 -0
  51. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/ast/utils.py +0 -0
  52. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/code_generation.py +0 -0
  53. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/compiler/__init__.py +0 -0
  54. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/compiler/cte_utils.py +0 -0
  55. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/compiler/large_query_breakdown.py +0 -0
  56. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/compiler/plan_compiler.py +0 -0
  57. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/compiler/query_generator.py +0 -0
  58. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/compiler/repeated_subquery_elimination.py +0 -0
  59. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/compiler/telemetry_constants.py +0 -0
  60. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/compiler/utils.py +0 -0
  61. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/data_source/__init__.py +0 -0
  62. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/data_source/datasource_partitioner.py +0 -0
  63. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/data_source/datasource_reader.py +0 -0
  64. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/data_source/datasource_typing.py +0 -0
  65. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/data_source/dbms_dialects/__init__.py +0 -0
  66. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/data_source/dbms_dialects/base_dialect.py +0 -0
  67. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/data_source/dbms_dialects/databricks_dialect.py +0 -0
  68. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/data_source/dbms_dialects/mysql_dialect.py +0 -0
  69. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/data_source/dbms_dialects/oracledb_dialect.py +0 -0
  70. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/data_source/dbms_dialects/postgresql_dialect.py +0 -0
  71. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/data_source/dbms_dialects/sqlite3_dialect.py +0 -0
  72. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/data_source/dbms_dialects/sqlserver_dialect.py +0 -0
  73. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/data_source/drivers/__init__.py +0 -0
  74. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/data_source/drivers/base_driver.py +0 -0
  75. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/data_source/drivers/databricks_driver.py +0 -0
  76. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/data_source/drivers/oracledb_driver.py +0 -0
  77. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/data_source/drivers/psycopg2_driver.py +0 -0
  78. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/data_source/drivers/pymsql_driver.py +0 -0
  79. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/data_source/drivers/pyodbc_driver.py +0 -0
  80. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/data_source/drivers/sqlite_driver.py +0 -0
  81. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/data_source/jdbc.py +0 -0
  82. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/data_source/utils.py +0 -0
  83. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/debug_utils.py +0 -0
  84. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/document_reader.py +0 -0
  85. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/document_reader_options.py +0 -0
  86. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/error_message.py +0 -0
  87. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/event_table_telemetry.py +0 -0
  88. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/open_telemetry.py +0 -0
  89. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/options.py +0 -0
  90. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/packaging_utils.py +0 -0
  91. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/pdf_reader.py +0 -0
  92. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/polars_backend.py +0 -0
  93. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/proto/generated/__init__.py +0 -0
  94. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/proto/generated/ast_pb2.py +0 -0
  95. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/proto/generated/ast_pb2.pyi +0 -0
  96. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/select_projection_complexity_utils.py +0 -0
  97. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/server_connection.py +0 -0
  98. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/snowpark_profiler.py +0 -0
  99. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/telemetry.py +0 -0
  100. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/temp_table_auto_cleaner.py +0 -0
  101. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/type_utils.py +0 -0
  102. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/udf_utils.py +0 -0
  103. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/utils.py +0 -0
  104. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/xml_reader.py +0 -0
  105. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/xml_schema_inference.py +0 -0
  106. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/_internal/xpath_handlers.py +0 -0
  107. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/async_job.py +0 -0
  108. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/catalog.py +0 -0
  109. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/column.py +0 -0
  110. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/context.py +0 -0
  111. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/dataframe_ai_functions.py +0 -0
  112. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/dataframe_analytics_functions.py +0 -0
  113. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/dataframe_na_functions.py +0 -0
  114. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/dataframe_profiler.py +0 -0
  115. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/lineage.py +0 -0
  116. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/mock/__init__.py +0 -0
  117. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/mock/_analyzer.py +0 -0
  118. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/mock/_connection.py +0 -0
  119. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/mock/_constants.py +0 -0
  120. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/mock/_functions.py +0 -0
  121. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/mock/_nop_analyzer.py +0 -0
  122. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/mock/_nop_connection.py +0 -0
  123. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/mock/_nop_plan.py +0 -0
  124. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/mock/_options.py +0 -0
  125. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/mock/_pandas_util.py +0 -0
  126. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/mock/_plan.py +0 -0
  127. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/mock/_plan_builder.py +0 -0
  128. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/mock/_secret_detector.py +0 -0
  129. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/mock/_select_statement.py +0 -0
  130. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/mock/_snowflake_data_type.py +0 -0
  131. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/mock/_snowflake_to_pandas_converter.py +0 -0
  132. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/mock/_stage_registry.py +0 -0
  133. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/mock/_stored_procedure.py +0 -0
  134. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/mock/_telemetry.py +0 -0
  135. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/mock/_udaf.py +0 -0
  136. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/mock/_udf.py +0 -0
  137. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/mock/_udf_utils.py +0 -0
  138. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/mock/_udtf.py +0 -0
  139. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/mock/_util.py +0 -0
  140. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/mock/_window_utils.py +0 -0
  141. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/mock/exceptions.py +0 -0
  142. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/__init__.py +0 -0
  143. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/config/__init__.py +0 -0
  144. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/config/__main__.py +0 -0
  145. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/config/envvars.py +0 -0
  146. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/config/pubsub.py +0 -0
  147. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/conftest.py +0 -0
  148. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/__init__.py +0 -0
  149. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/__init__.py +0 -0
  150. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/aggregation_utils.py +0 -0
  151. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/align_utils.py +0 -0
  152. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/apply_utils.py +0 -0
  153. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/binary_op_utils.py +0 -0
  154. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/concat_utils.py +0 -0
  155. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/cumulative_utils.py +0 -0
  156. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/cut_utils.py +0 -0
  157. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/frame.py +0 -0
  158. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/generator_utils.py +0 -0
  159. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/get_dummies_utils.py +0 -0
  160. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/groupby_utils.py +0 -0
  161. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/indexing_utils.py +0 -0
  162. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/io_utils.py +0 -0
  163. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/isin_utils.py +0 -0
  164. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/join_utils.py +0 -0
  165. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/ordered_dataframe.py +0 -0
  166. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/pivot_utils.py +0 -0
  167. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/resample_utils.py +0 -0
  168. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/row_count_estimation.py +0 -0
  169. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/session.py +0 -0
  170. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/snowpark_pandas_types.py +0 -0
  171. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/statement_params_constants.py +0 -0
  172. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/telemetry.py +0 -0
  173. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/timestamp_utils.py +0 -0
  174. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/transpose_utils.py +0 -0
  175. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/type_utils.py +0 -0
  176. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/unpivot_utils.py +0 -0
  177. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/utils.py +0 -0
  178. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/where_utils.py +0 -0
  179. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_internal/window_utils.py +0 -0
  180. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/_typing.py +0 -0
  181. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/compiler/__init__.py +0 -0
  182. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/compiler/doc_utils.py +0 -0
  183. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/compiler/ray_utils.py +0 -0
  184. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/compiler/snowflake_query_compiler.py +0 -0
  185. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/docstrings/__init__.py +0 -0
  186. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/docstrings/base.py +0 -0
  187. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/docstrings/dataframe.py +0 -0
  188. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/docstrings/datetime_index.py +0 -0
  189. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/docstrings/general.py +0 -0
  190. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/docstrings/groupby.py +0 -0
  191. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/docstrings/index.py +0 -0
  192. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/docstrings/io.py +0 -0
  193. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/docstrings/resample.py +0 -0
  194. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/docstrings/series.py +0 -0
  195. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/docstrings/series_utils.py +0 -0
  196. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/docstrings/shared_docs.py +0 -0
  197. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/docstrings/timedelta_index.py +0 -0
  198. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/docstrings/window.py +0 -0
  199. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/extensions/__init__.py +0 -0
  200. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/extensions/base_overrides.py +0 -0
  201. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/extensions/dataframe_extensions.py +0 -0
  202. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/extensions/dataframe_groupby_overrides.py +0 -0
  203. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/extensions/dataframe_overrides.py +0 -0
  204. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/extensions/datetime_index.py +0 -0
  205. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/extensions/general_overrides.py +0 -0
  206. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/extensions/index.py +0 -0
  207. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/extensions/indexing_overrides.py +0 -0
  208. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/extensions/io_overrides.py +0 -0
  209. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/extensions/resample_overrides.py +0 -0
  210. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/extensions/resampler_groupby_overrides.py +0 -0
  211. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/extensions/rolling_groupby_overrides.py +0 -0
  212. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/extensions/series_extensions.py +0 -0
  213. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/extensions/series_groupby_overrides.py +0 -0
  214. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/extensions/series_overrides.py +0 -0
  215. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/extensions/snow_partition_iterator.py +0 -0
  216. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/extensions/timedelta_index.py +0 -0
  217. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/extensions/utils.py +0 -0
  218. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/extensions/window_overrides.py +0 -0
  219. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/io/__init__.py +0 -0
  220. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/io/factories.py +0 -0
  221. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/io/snow_io.py +0 -0
  222. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/utils/__init__.py +0 -0
  223. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/utils/error_message.py +0 -0
  224. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/utils/exceptions.py +0 -0
  225. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/utils/frontend_constants.py +0 -0
  226. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/utils/numpy_to_pandas.py +0 -0
  227. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/plugin/utils/warning_message.py +0 -0
  228. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/modin/utils.py +0 -0
  229. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/py.typed +0 -0
  230. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/query_history.py +0 -0
  231. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/relational_grouped_dataframe.py +0 -0
  232. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/row.py +0 -0
  233. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/secrets.py +0 -0
  234. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/stored_procedure.py +0 -0
  235. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/stored_procedure_profiler.py +0 -0
  236. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/table_function.py +0 -0
  237. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/testing.py +0 -0
  238. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/types.py +0 -0
  239. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/udaf.py +0 -0
  240. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/udf.py +0 -0
  241. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/udf_profiler.py +0 -0
  242. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/udtf.py +0 -0
  243. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake/snowpark/window.py +0 -0
  244. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake_snowpark_python.egg-info/SOURCES.txt +0 -0
  245. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake_snowpark_python.egg-info/dependency_links.txt +0 -0
  246. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake_snowpark_python.egg-info/namespace_packages.txt +0 -0
  247. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake_snowpark_python.egg-info/not-zip-safe +0 -0
  248. {snowflake_snowpark_python-1.55.1 → snowflake_snowpark_python-1.55.2}/src/snowflake_snowpark_python.egg-info/top_level.txt +0 -0
@@ -1,5 +1,15 @@
1
1
  # Release History
2
2
 
3
+ ## 1.55.2 (2026-10-13)
4
+
5
+ ### Snowpark Python API Updates
6
+
7
+ #### Bug Fixes
8
+ - Fixed nested UDxF registration inside a stored procedure inheriting inaccessible app-package stage paths from the procedure's `IMPORTS` clause.
9
+
10
+ #### Improvements
11
+ - Bumped cloudpickle dependency to also support `cloudpickle==3.1.2` in addition to previous versions.
12
+
3
13
  ## 1.55.1 (2026-10-05)
4
14
 
5
15
  ### Snowpark Python API Updates
@@ -15,6 +25,8 @@
15
25
 
16
26
  - Updated `ai_redact(..., mode="detect")` and `DataFrame.ai.redact(..., mode="detect")` to document that detect mode returns an ARRAY of span objects, not an OBJECT with a `spans` field.
17
27
 
28
+ #### Improvements
29
+
18
30
  ## 1.55.0 (2026-09-10)
19
31
 
20
32
  ### Snowpark Python API Updates
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: snowflake-snowpark-python
3
- Version: 1.55.1
3
+ Version: 1.55.2
4
4
  Summary: Snowflake Snowpark for Python
5
5
  Home-page: https://www.snowflake.com/
6
6
  Author: Snowflake, Inc
@@ -40,7 +40,7 @@ Requires-Dist: wheel
40
40
  Requires-Dist: snowflake-connector-python<5.0.0,>=3.17.0
41
41
  Requires-Dist: typing-extensions<5.0.0,>=4.1.0
42
42
  Requires-Dist: pyyaml
43
- Requires-Dist: cloudpickle!=2.1.0,!=2.2.0,<=3.1.1,>=1.6.0
43
+ Requires-Dist: cloudpickle!=2.1.0,!=2.2.0,<=3.1.2,>=1.6.0
44
44
  Requires-Dist: protobuf<6.34,>=3.20; python_version < "3.14"
45
45
  Requires-Dist: protobuf<6.34,>=5.29.0; python_version >= "3.14"
46
46
  Requires-Dist: python-dateutil
@@ -26,7 +26,7 @@ INSTALL_REQ_LIST = [
26
26
  # snowpark directly depends on typing-extension, so we should not remove it even if connector also depends on it.
27
27
  "typing-extensions>=4.1.0, <5.0.0",
28
28
  "pyyaml",
29
- "cloudpickle>=1.6.0,<=3.1.1,!=2.1.0,!=2.2.0",
29
+ "cloudpickle>=1.6.0,<=3.1.2,!=2.1.0,!=2.2.0",
30
30
  # `protoc` < 3.20 is not able to generate protobuf code compatible with protobuf >= 3.20.
31
31
  "protobuf>=3.20, <6.34; python_version < '3.14'", # Snowpark IR
32
32
  # py314: protoc-wheel-0 has no cp314 wheel; setup.py uses libprotobuf's protoc from PATH.
@@ -814,6 +814,22 @@ class DataFrame:
814
814
 
815
815
  See also:
816
816
  :meth:`collect_nowait()`
817
+
818
+ The default blocking call retrieves all result rows into client memory.
819
+ For large results, consider :meth:`to_local_iterator` instead of
820
+ materializing a list. Use :meth:`sort` before collecting when the order
821
+ of rows matters.
822
+
823
+ Example::
824
+
825
+ >>> df = session.create_dataframe([(2, "Bob"), (1, "Alice")], schema=["id", "name"])
826
+ >>> rows = df.sort("id").collect()
827
+ >>> rows
828
+ [Row(ID=1, NAME='Alice'), Row(ID=2, NAME='Bob')]
829
+ >>> rows[0]["NAME"]
830
+ 'Alice'
831
+ >>> rows[1].ID
832
+ 2
817
833
  """
818
834
 
819
835
  kwargs = {}
@@ -6184,14 +6200,33 @@ class DataFrame:
6184
6200
  n: Optional[int] = None,
6185
6201
  _emit_ast: bool = True,
6186
6202
  ) -> "DataFrame":
6187
- """Samples rows based on either the number of rows to be returned or a
6188
- percentage of rows to be returned.
6203
+ """Returns a random sample of rows using Snowflake's SQL SAMPLE clause.
6204
+
6205
+ Specify either ``frac`` or ``n``. Fractional sampling includes each row
6206
+ with the given probability, so the number of returned rows can vary.
6207
+ Fixed-size sampling returns the requested number of rows, or all rows
6208
+ if the input contains fewer rows. Neither form guarantees row order.
6209
+ Repeated executions can return different samples; this method has no
6210
+ seed parameter. For seeded sampling of a table, see :meth:`Table.sample`.
6211
+
6212
+ See `SAMPLE <https://docs.snowflake.com/en/sql-reference/constructs/sample>`_
6213
+ for SQL sampling semantics.
6189
6214
 
6190
6215
  Args:
6191
- frac: the percentage of rows to be sampled.
6216
+ frac: The probability of selecting each row, from 0.0 to 1.0
6217
+ inclusive. For example, 0.1 requests approximately 10 percent
6218
+ of the rows, not exactly 10 percent.
6192
6219
  n: the number of rows to sample in the range of 0 to 1,000,000 (inclusive).
6220
+
6193
6221
  Returns:
6194
6222
  a :class:`DataFrame` containing the sample of rows.
6223
+
6224
+ Examples::
6225
+
6226
+ >>> df = session.range(100)
6227
+ >>> fractional_sample = df.sample(frac=0.1)
6228
+ >>> fixed_sample = df.sample(n=5)
6229
+ >>> assert fixed_sample.count() == 5
6195
6230
  """
6196
6231
  DataFrame._validate_sample_input(frac, n)
6197
6232
 
@@ -6247,6 +6282,15 @@ class DataFrame:
6247
6282
  """
6248
6283
  Returns a :class:`DataFrameAIFunctions` object that provides AI-powered functions
6249
6284
  for the DataFrame.
6285
+
6286
+ Access this namespace through an existing DataFrame, for example
6287
+ ``df.ai``. It is not a column and accessing it does not itself execute
6288
+ an AI function. Call a method on the namespace to build an AI operation.
6289
+
6290
+ See :meth:`DataFrameAIFunctions.classify`,
6291
+ :meth:`DataFrameAIFunctions.extract`, and
6292
+ :meth:`DataFrameAIFunctions.sentiment` for parameters and examples.
6293
+ The :class:`DataFrameAIFunctions` reference lists the available methods.
6250
6294
  """
6251
6295
  return self._ai
6252
6296
 
@@ -6905,6 +6949,25 @@ class DataFrame:
6905
6949
  Returns a ``dict`` that contains a list of queries that will be executed to
6906
6950
  evaluate this DataFrame with the key `queries`, and a list of post-execution
6907
6951
  actions (e.g., queries to clean up temporary objects) with the key `post_actions`.
6952
+
6953
+ ``queries`` contains SQL statements in the DataFrame's execution plan;
6954
+ a plan can contain more than one statement. ``post_actions`` contains
6955
+ cleanup statements associated with that plan and can be empty. These
6956
+ lists aren't result rows or a history of previously executed queries.
6957
+
6958
+ Use :meth:`explain` for a printed query list and, when available, a
6959
+ database execution plan. Use :meth:`Session.query_history` to record
6960
+ queries executed through a session. Generated SQL can change between
6961
+ library versions and configurations; don't rely on exact SQL text.
6962
+
6963
+ Example::
6964
+
6965
+ >>> df = session.range(3)
6966
+ >>> planned_sql = df.queries
6967
+ >>> sorted(planned_sql)
6968
+ ['post_actions', 'queries']
6969
+ >>> isinstance(planned_sql["queries"], list)
6970
+ True
6908
6971
  """
6909
6972
  plan_queries = self._plan.execution_queries
6910
6973
  return {
@@ -1026,6 +1026,26 @@ class DataFrameReader:
1026
1026
  def csv(self, path: str, _emit_ast: bool = True) -> DataFrame:
1027
1027
  """Specify the path of the CSV file(s) to load.
1028
1028
 
1029
+ Configure the reader with :meth:`option`, :meth:`options`, and
1030
+ :meth:`schema` before calling ``csv``. Options are not keyword
1031
+ arguments of this method. Common CSV format options include
1032
+ ``FIELD_DELIMITER``, ``SKIP_HEADER``, and
1033
+ ``FIELD_OPTIONALLY_ENCLOSED_BY``. See the
1034
+ `CSV format options
1035
+ <https://docs.snowflake.com/en/sql-reference/sql/create-file-format#type-csv>`_
1036
+ for their accepted values.
1037
+
1038
+ Provide a schema explicitly or enable the reader's ``INFER_SCHEMA``
1039
+ option. Schema inference can issue queries while constructing the
1040
+ DataFrame and is not supported for CSV in local testing mode.
1041
+
1042
+ Example (requires an existing stage containing a header row and two
1043
+ comma-separated columns)::
1044
+
1045
+ >>> from snowflake.snowpark.types import StructType, StructField, IntegerType, StringType
1046
+ >>> schema = StructType([StructField("id", IntegerType()), StructField("name", StringType())])
1047
+ >>> df = session.read.schema(schema).option("SKIP_HEADER", 1).csv("@my_stage/people.csv") # doctest: +SKIP
1048
+
1029
1049
  Args:
1030
1050
  path: The stage location of a CSV file, or a stage location that has CSV files.
1031
1051
 
@@ -74,7 +74,9 @@ class DataFrameStatFunctions:
74
74
 
75
75
  Args:
76
76
  col: The name of the numeric column.
77
- percentile: A list of float values greater than or equal to 0.0 and less than 1.0.
77
+ percentile: A list of float values between 0.0 and 1.0, inclusive.
78
+ For example, 0.5 requests the approximate median and 1.0 requests
79
+ the approximate maximum.
78
80
  statement_params: Dictionary of statement level parameters to be set while executing this action.
79
81
 
80
82
  Returns:
@@ -426,6 +428,12 @@ class DataFrameStatFunctions:
426
428
  ) -> "snowflake.snowpark.DataFrame":
427
429
  """Returns a DataFrame containing a stratified sample without replacement, based on a ``dict`` that specifies the fraction for each stratum.
428
430
 
431
+ ``df.stat`` is the :class:`DataFrameStatFunctions` accessor for ``df``;
432
+ it groups statistical operations and doesn't select a column named
433
+ ``stat``. ``df.stat.sample_by(...)``, ``df.sample_by(...)``, and
434
+ ``df.sampleBy(...)`` call the same sampling operation. Separate calls
435
+ can return different random samples.
436
+
429
437
  Example::
430
438
 
431
439
  >>> df = session.create_dataframe([("Bob", 17), ("Alice", 10), ("Nico", 8), ("Bob", 12)], schema=["name", "age"])
@@ -275,8 +275,9 @@ class DataFrameWriter:
275
275
 
276
276
  column_order: When ``mode`` is "append", data will be inserted into the target table by matching column sequence or column name. Default is "index". When ``mode`` is not "append", the ``column_order`` makes no difference.
277
277
 
278
- "index": Data will be inserted into the target table by column sequence.
279
- "name": Data will be inserted into the target table by matching column names. If the target table has more columns than the source DataFrame, use this one.
278
+ - ``"index"``: Data will be inserted into the target table by column sequence.
279
+ - ``"name"``: Data will be inserted into the target table by matching column names.
280
+ If the target table has more columns than the source DataFrame, use this one.
280
281
 
281
282
  create_temp_table: (Deprecated) The to-be-created table will be temporary if this is set to ``True``.
282
283
  table_type: The table type of table to be created. The supported values are: ``temp``, ``temporary``,
@@ -77,6 +77,23 @@ class SnowparkSQLException(SnowparkClientException):
77
77
  Includes all error codes in range 13XX (where XX is 0-9).
78
78
 
79
79
  This exception is specifically raised for error codes: 1300, 1304.
80
+
81
+ Attributes:
82
+ error_code: Snowpark client error code. This is distinct from the
83
+ underlying Snowflake SQL error code.
84
+ sql_error_code: Snowflake SQL error number, when provided by the connector.
85
+ sfqid: Snowflake query ID, when available. Use this to locate the failed
86
+ statement in `Query History
87
+ <https://docs.snowflake.com/en/user-guide/ui-query-history>`_.
88
+ query: SQL text associated with the error, when available.
89
+ raw_message: Underlying error message, when available.
90
+ conn_error: Original connector exception, when available.
91
+
92
+ Read the error message first: a compilation error, missing object, and
93
+ insufficient privilege require different fixes even if they share a
94
+ Snowpark error code. Check the failed query's database, schema, role, and
95
+ referenced identifiers. When requesting help, include the query ID and
96
+ error codes; redact sensitive literals from SQL and error messages.
80
97
  """
81
98
 
82
99
  def __init__(
@@ -24,7 +24,29 @@ from snowflake.snowpark._internal.utils import (
24
24
 
25
25
 
26
26
  class PutResult(NamedTuple):
27
- """Represents the results of uploading a local file to a stage location."""
27
+ """Represents the results of uploading a local file to a stage location.
28
+
29
+ :meth:`FileOperation.put` returns a list of these objects. Inspect each
30
+ object's ``source``, ``target``, ``status``, and ``message`` attributes to
31
+ identify the file and its upload outcome. ``SKIPPED`` means the file wasn't
32
+ uploaded; it doesn't mean a new upload succeeded.
33
+
34
+ This example requires an existing internal stage named ``example_stage``
35
+ and a session authorized to upload to it. It creates only a local text
36
+ fixture; use a stage intended for testing. File names and sizes in the
37
+ returned objects depend on the input and compression options.
38
+
39
+ Example::
40
+
41
+ >>> from pathlib import Path
42
+ >>> from tempfile import TemporaryDirectory
43
+ >>> with TemporaryDirectory() as directory: # doctest: +SKIP
44
+ ... path = Path(directory) / "message.txt"
45
+ ... _ = path.write_text("hello", encoding="utf-8")
46
+ ... results = session.file.put(str(path), "@example_stage", auto_compress=False)
47
+ ... for result in results:
48
+ ... print(result.source, result.target, result.status, result.message)
49
+ """
28
50
 
29
51
  source: str #: The source file path.
30
52
  target: str #: The file path in the stage where the source file is uploaded.
@@ -191,6 +213,12 @@ class FileOperation:
191
213
  The command lists all files in the specified path and applies the regular expression pattern on each of the files found.
192
214
  Default: ``None`` (all files in the specified stage are downloaded).
193
215
  statement_params: Dictionary of statement level parameters to be set while executing this action.
216
+ For example, ``{"QUERY_TAG": "download_files"}`` tags the GET
217
+ statement. See `Snowflake parameters
218
+ <https://docs.snowflake.com/en/sql-reference/parameters>`_ for
219
+ parameter meanings and allowed values. Only parameters supported
220
+ at statement level apply; this is not a way to set account-only
221
+ parameters or GET options such as ``parallel`` and ``pattern``.
194
222
 
195
223
  Returns:
196
224
  A ``list`` of :class:`GetResult` instances, each of which represents the result of a downloaded file.
@@ -156,7 +156,19 @@ class SnowflakeFile(RawIOBase):
156
156
  require_scoped_url: bool = True,
157
157
  ) -> SnowflakeFile:
158
158
  """
159
- Used to create a :class:`~snowflake.snowpark.file.SnowflakeFile` which can only be used for read-based IO operations on the file.
159
+ Opens a file for reading and returns a :class:`SnowflakeFile` stream.
160
+ Use a ``with`` statement to close the stream after reading.
161
+
162
+ For example, inside a handler with a caller-provided scoped URL::
163
+
164
+ from snowflake.snowpark.files import SnowflakeFile
165
+
166
+ def read_text(url):
167
+ with SnowflakeFile.open(url, "r") as source:
168
+ return source.read()
169
+
170
+ This example reads the whole file into memory. Use binary mode
171
+ (``"rb"``) when the consumer expects bytes rather than text.
160
172
 
161
173
  In UDFs and Stored Procedures, the object works like a read-only Python IOBase object and as a wrapper for an IO stream of remote files.
162
174
 
@@ -7005,6 +7005,16 @@ def array_agg(
7005
7005
  """Returns the input values, pivoted into an ARRAY. If the input is empty, an empty
7006
7006
  ARRAY is returned.
7007
7007
 
7008
+ Element order is unpredictable unless you specify :meth:`Column.within_group`
7009
+ on the aggregate expression. Sorting the result DataFrame orders result
7010
+ rows, not the elements inside each array. This also applies to the
7011
+ ``collect_list`` alias. When ``is_distinct=True``, the ordering expression
7012
+ must refer to the same column as the aggregate input.
7013
+
7014
+ For example, this expression orders elements within each array by ``a``::
7015
+
7016
+ >>> ordered_values = array_agg("a").within_group("a")
7017
+
7008
7018
  Example::
7009
7019
  >>> df = session.create_dataframe([[1], [2], [3], [1]], schema=["a"])
7010
7020
  >>> df.select(array_agg("a", True).within_group("a").alias("result")).show()
@@ -7018,6 +7028,18 @@ def array_agg(
7018
7028
  |] |
7019
7029
  ------------
7020
7030
  <BLANKLINE>
7031
+
7032
+ ``collect_list`` is an alias of ``array_agg`` with the same arguments and
7033
+ behavior. The two names share this documentation, which is why the example
7034
+ above uses ``array_agg``. By default, duplicates are retained.
7035
+
7036
+ This example produces an array containing ``[1, 2, 2]``:
7037
+
7038
+ Example using the alias::
7039
+
7040
+ >>> from snowflake.snowpark.functions import collect_list
7041
+ >>> df = session.create_dataframe([[2], [1], [2]], schema=["a"])
7042
+ >>> result = df.select(collect_list("a").within_group("a").alias("values")).collect()
7021
7043
  """
7022
7044
  ast = build_function_expr("array_agg", [col, is_distinct]) if _emit_ast else None
7023
7045
  c = _to_col_if_str(col, "array_agg")
@@ -7334,7 +7356,10 @@ def array_insert(
7334
7356
  def array_position(
7335
7357
  variant: ColumnOrName, array: ColumnOrName, _emit_ast: bool = True
7336
7358
  ) -> Column:
7337
- """Returns the index of the first occurrence of an element in an ARRAY.
7359
+ """Returns the zero-based index of the first occurrence of an element in an ARRAY.
7360
+
7361
+ The first element has index 0. If the value is not present, returns SQL NULL
7362
+ (represented by ``None`` in a collected Row), not -1.
7338
7363
 
7339
7364
  Args:
7340
7365
  variant: Column containing the VARIANT value that you want to find. The function
@@ -7342,16 +7367,16 @@ def array_position(
7342
7367
  array: Column containing the ARRAY to be searched.
7343
7368
 
7344
7369
  Example::
7345
- >>> from snowflake.snowpark import Row
7346
- >>> df = session.create_dataframe([Row([2, 1]), Row([1, 3])], schema=["a"])
7347
- >>> df.select(array_position(lit(1), "a").alias("result")).show()
7348
- ------------
7349
- |"RESULT" |
7350
- ------------
7351
- |1 |
7352
- |0 |
7353
- ------------
7354
- <BLANKLINE>
7370
+ >>> from snowflake.snowpark.functions import array_position, lit
7371
+ >>> df = session.create_dataframe(
7372
+ ... [(1, [2, 1, 1]), (2, [1, 3]), (3, [4, 5])],
7373
+ ... schema=["id", "values"])
7374
+ >>> df.select("id", array_position(lit(1), "values").alias("position")).sort("id").collect()
7375
+ [Row(ID=1, POSITION=1), Row(ID=2, POSITION=0), Row(ID=3, POSITION=None)]
7376
+
7377
+ In the first row, 1 appears twice; the result is the position of its first
7378
+ occurrence. Use :func:`lit` to search for a literal value rather than a
7379
+ column name.
7355
7380
  """
7356
7381
  v = _to_col_if_str(variant, "array_position")
7357
7382
  a = _to_col_if_str(array, "array_position")
@@ -8812,13 +8837,20 @@ def iff(
8812
8837
  expr1: A :class:`Column` expression or a literal value, which will be returned
8813
8838
  if ``condition`` is true.
8814
8839
  expr2: A :class:`Column` expression or a literal value, which will be returned
8815
- if ``condition`` is false.
8840
+ if ``condition`` is false or NULL.
8816
8841
 
8817
8842
  Examples::
8818
8843
 
8819
- >>> df = session.create_dataframe([True, False, None], schema=["a"])
8820
- >>> df.select(iff(df["a"], lit("true"), lit("false")).alias("iff")).collect()
8821
- [Row(IFF='true'), Row(IFF='false'), Row(IFF='false')]
8844
+ >>> from snowflake.snowpark.functions import iff, lit
8845
+ >>> df = session.create_dataframe(
8846
+ ... [(1, True), (2, False), (3, None)], schema=["id", "approved"])
8847
+ >>> df.select(
8848
+ ... "id", iff(df["approved"], lit("ship"), lit("hold")).alias("action")
8849
+ ... ).sort("id").collect()
8850
+ [Row(ID=1, ACTION='ship'), Row(ID=2, ACTION='hold'), Row(ID=3, ACTION='hold')]
8851
+
8852
+ Only an approved row selects ``"ship"``. Both false and unknown (NULL)
8853
+ approval select ``"hold"``.
8822
8854
  """
8823
8855
  ast = build_function_expr("iff", [condition, expr1, expr2]) if _emit_ast else None
8824
8856
  return _call_function(
@@ -13040,7 +13072,7 @@ def ai_extract(
13040
13072
  ... col("text"),
13041
13073
  ... ai_extract(col("text"), [['name', 'What is the first name?'], ['city', 'What city do they work in?']]).alias("info")
13042
13074
  ... )
13043
- >>> extracted_df.show()
13075
+ >>> extracted_df.sort(col("text")).show()
13044
13076
  ------------------------------------------------------------
13045
13077
  |"TEXT" |"INFO" |
13046
13078
  ------------------------------------------------------------
@@ -13239,7 +13271,7 @@ def ai_filter(
13239
13271
  ... ai_filter(prompt("Is {0} in Europe?", col("country"))).as_("europe"),
13240
13272
  ... ai_filter(prompt("Is {0} in North America?", col("country"))).as_("north_america"),
13241
13273
  ... ai_filter(prompt("Is {0} in Central America?", col("country"))).as_("central_america"),
13242
- ... ).show()
13274
+ ... ).sort("asia").show()
13243
13275
  -----------------------------------------------------------
13244
13276
  |"ASIA" |"EUROPE" |"NORTH_AMERICA" |"CENTRAL_AMERICA" |
13245
13277
  -----------------------------------------------------------
@@ -14257,11 +14289,11 @@ def ai_sentiment(
14257
14289
  ... ["The food was delicious but the service was slow."],
14258
14290
  ... ["The movie was great, but the acting was terrible."]
14259
14291
  ... ], schema=["review"])
14260
- >>> df.select("review", ai_sentiment(col("review"), ['plot', 'visual effects', 'acting']).alias("sentiment")).show()
14292
+ >>> df.select("review", ai_sentiment(col("review"), ['plot', 'visual effects', 'acting']).alias("sentiment")).sort("review").show()
14261
14293
  ----------------------------------------------------------------------------------------
14262
14294
  |"REVIEW" |"SENTIMENT" |
14263
14295
  ----------------------------------------------------------------------------------------
14264
- |The movie had amazing visual effects but the pl... |{ |
14296
+ |The food was delicious but the service was slow. |{ |
14265
14297
  | | "categories": [ |
14266
14298
  | | { |
14267
14299
  | | "name": "overall", |
@@ -14269,19 +14301,19 @@ def ai_sentiment(
14269
14301
  | | }, |
14270
14302
  | | { |
14271
14303
  | | "name": "acting", |
14272
- | | "sentiment": "neutral" |
14304
+ | | "sentiment": "unknown" |
14273
14305
  | | }, |
14274
14306
  | | { |
14275
14307
  | | "name": "plot", |
14276
- | | "sentiment": "negative" |
14308
+ | | "sentiment": "unknown" |
14277
14309
  | | }, |
14278
14310
  | | { |
14279
14311
  | | "name": "visual effects", |
14280
- | | "sentiment": "positive" |
14312
+ | | "sentiment": "unknown" |
14281
14313
  | | } |
14282
14314
  | | ] |
14283
14315
  | |} |
14284
- |The food was delicious but the service was slow. |{ |
14316
+ |The movie had amazing visual effects but the pl... |{ |
14285
14317
  | | "categories": [ |
14286
14318
  | | { |
14287
14319
  | | "name": "overall", |
@@ -14289,15 +14321,15 @@ def ai_sentiment(
14289
14321
  | | }, |
14290
14322
  | | { |
14291
14323
  | | "name": "acting", |
14292
- | | "sentiment": "unknown" |
14324
+ | | "sentiment": "neutral" |
14293
14325
  | | }, |
14294
14326
  | | { |
14295
14327
  | | "name": "plot", |
14296
- | | "sentiment": "unknown" |
14328
+ | | "sentiment": "negative" |
14297
14329
  | | }, |
14298
14330
  | | { |
14299
14331
  | | "name": "visual effects", |
14300
- | | "sentiment": "unknown" |
14332
+ | | "sentiment": "positive" |
14301
14333
  | | } |
14302
14334
  | | ] |
14303
14335
  | |} |
@@ -513,6 +513,41 @@ def to_snowflake(
513
513
  index_label: Optional[IndexLabel] = None,
514
514
  table_type: Literal["", "temp", "temporary", "transient"] = "",
515
515
  ) -> None:
516
+ """Save a Snowpark pandas DataFrame or Series as a Snowflake table.
517
+
518
+ Args:
519
+ obj: The Snowpark pandas DataFrame or Series to write.
520
+ name: Destination table name or fully-qualified identifier, such as
521
+ ``"MY_DB.MY_SCHEMA.MY_TABLE"`` or
522
+ ``["MY_DB", "MY_SCHEMA", "MY_TABLE"]``. Unqualified names use the
523
+ session's current database and schema. Double-quote identifier
524
+ components to preserve mixed case.
525
+ if_exists: How to handle an existing table. Defaults to ``"fail"``:
526
+
527
+ - ``"fail"``: Raise ValueError if the table exists.
528
+ - ``"replace"``: Drop the table and write the new values.
529
+ - ``"append"``: Add rows to the existing table.
530
+
531
+ index: If True (the default), save index levels as table columns in
532
+ addition to the data columns. Set False to omit the index.
533
+ index_label: Column label or labels for the saved index. Defaults to
534
+ the index names. Supply a label for an unnamed index and one label
535
+ per level for a MultiIndex. Labels must not duplicate data-column
536
+ labels. Ignored when ``index=False``.
537
+ table_type: Type of table to create: ``"temp"`` or ``"temporary"``,
538
+ ``"transient"``, or ``""`` (the default) for a permanent table.
539
+ See `table types
540
+ <https://docs.snowflake.com/en/user-guide/tables-temp-transient>`_.
541
+
542
+ Returns:
543
+ None. The write is executed by this call. Row ordering is not preserved
544
+ by a Snowflake table.
545
+
546
+ See also:
547
+ :func:`DataFrame.to_snowflake <modin.pandas.DataFrame.to_snowflake>`,
548
+ :func:`Series.to_snowflake <modin.pandas.Series.to_snowflake>`,
549
+ :func:`read_snowflake <modin.pandas.read_snowflake>`.
550
+ """
516
551
  _snowpark_pandas_obj_check(obj)
517
552
  return obj.to_snowflake(
518
553
  name=name,