oracle-ads 2.13.9rc0__py3-none-any.whl → 2.13.10__py3-none-any.whl

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 (858) hide show
  1. ads/aqua/__init__.py +40 -0
  2. ads/aqua/app.py +507 -0
  3. ads/aqua/cli.py +96 -0
  4. ads/aqua/client/__init__.py +3 -0
  5. ads/aqua/client/client.py +836 -0
  6. ads/aqua/client/openai_client.py +305 -0
  7. ads/aqua/common/__init__.py +5 -0
  8. ads/aqua/common/decorator.py +125 -0
  9. ads/aqua/common/entities.py +274 -0
  10. ads/aqua/common/enums.py +134 -0
  11. ads/aqua/common/errors.py +109 -0
  12. ads/aqua/common/utils.py +1295 -0
  13. ads/aqua/config/__init__.py +4 -0
  14. ads/aqua/config/container_config.py +246 -0
  15. ads/aqua/config/evaluation/__init__.py +4 -0
  16. ads/aqua/config/evaluation/evaluation_service_config.py +147 -0
  17. ads/aqua/config/utils/__init__.py +4 -0
  18. ads/aqua/config/utils/serializer.py +339 -0
  19. ads/aqua/constants.py +116 -0
  20. ads/aqua/data.py +14 -0
  21. ads/aqua/dummy_data/icon.txt +1 -0
  22. ads/aqua/dummy_data/oci_model_deployments.json +56 -0
  23. ads/aqua/dummy_data/oci_models.json +1 -0
  24. ads/aqua/dummy_data/readme.md +26 -0
  25. ads/aqua/evaluation/__init__.py +8 -0
  26. ads/aqua/evaluation/constants.py +53 -0
  27. ads/aqua/evaluation/entities.py +186 -0
  28. ads/aqua/evaluation/errors.py +70 -0
  29. ads/aqua/evaluation/evaluation.py +1814 -0
  30. ads/aqua/extension/__init__.py +42 -0
  31. ads/aqua/extension/aqua_ws_msg_handler.py +76 -0
  32. ads/aqua/extension/base_handler.py +90 -0
  33. ads/aqua/extension/common_handler.py +121 -0
  34. ads/aqua/extension/common_ws_msg_handler.py +36 -0
  35. ads/aqua/extension/deployment_handler.py +381 -0
  36. ads/aqua/extension/deployment_ws_msg_handler.py +54 -0
  37. ads/aqua/extension/errors.py +30 -0
  38. ads/aqua/extension/evaluation_handler.py +129 -0
  39. ads/aqua/extension/evaluation_ws_msg_handler.py +61 -0
  40. ads/aqua/extension/finetune_handler.py +96 -0
  41. ads/aqua/extension/model_handler.py +390 -0
  42. ads/aqua/extension/models/__init__.py +0 -0
  43. ads/aqua/extension/models/ws_models.py +145 -0
  44. ads/aqua/extension/models_ws_msg_handler.py +50 -0
  45. ads/aqua/extension/ui_handler.py +300 -0
  46. ads/aqua/extension/ui_websocket_handler.py +130 -0
  47. ads/aqua/extension/utils.py +133 -0
  48. ads/aqua/finetuning/__init__.py +7 -0
  49. ads/aqua/finetuning/constants.py +23 -0
  50. ads/aqua/finetuning/entities.py +181 -0
  51. ads/aqua/finetuning/finetuning.py +749 -0
  52. ads/aqua/model/__init__.py +8 -0
  53. ads/aqua/model/constants.py +60 -0
  54. ads/aqua/model/entities.py +385 -0
  55. ads/aqua/model/enums.py +32 -0
  56. ads/aqua/model/model.py +2134 -0
  57. ads/aqua/model/utils.py +52 -0
  58. ads/aqua/modeldeployment/__init__.py +6 -0
  59. ads/aqua/modeldeployment/constants.py +10 -0
  60. ads/aqua/modeldeployment/deployment.py +1315 -0
  61. ads/aqua/modeldeployment/entities.py +653 -0
  62. ads/aqua/modeldeployment/utils.py +543 -0
  63. ads/aqua/resources/gpu_shapes_index.json +94 -0
  64. ads/aqua/server/__init__.py +4 -0
  65. ads/aqua/server/__main__.py +24 -0
  66. ads/aqua/server/app.py +47 -0
  67. ads/aqua/server/aqua_spec.yml +1291 -0
  68. ads/aqua/training/__init__.py +4 -0
  69. ads/aqua/training/exceptions.py +476 -0
  70. ads/aqua/ui.py +519 -0
  71. ads/automl/__init__.py +9 -0
  72. ads/automl/driver.py +330 -0
  73. ads/automl/provider.py +975 -0
  74. ads/bds/__init__.py +5 -0
  75. ads/bds/auth.py +127 -0
  76. ads/bds/big_data_service.py +255 -0
  77. ads/catalog/__init__.py +19 -0
  78. ads/catalog/model.py +1576 -0
  79. ads/catalog/notebook.py +461 -0
  80. ads/catalog/project.py +468 -0
  81. ads/catalog/summary.py +178 -0
  82. ads/common/__init__.py +11 -0
  83. ads/common/analyzer.py +65 -0
  84. ads/common/artifact/.model-ignore +63 -0
  85. ads/common/artifact/__init__.py +10 -0
  86. ads/common/auth.py +1122 -0
  87. ads/common/card_identifier.py +83 -0
  88. ads/common/config.py +647 -0
  89. ads/common/data.py +165 -0
  90. ads/common/decorator/__init__.py +9 -0
  91. ads/common/decorator/argument_to_case.py +88 -0
  92. ads/common/decorator/deprecate.py +69 -0
  93. ads/common/decorator/require_nonempty_arg.py +65 -0
  94. ads/common/decorator/runtime_dependency.py +178 -0
  95. ads/common/decorator/threaded.py +97 -0
  96. ads/common/decorator/utils.py +35 -0
  97. ads/common/dsc_file_system.py +303 -0
  98. ads/common/error.py +14 -0
  99. ads/common/extended_enum.py +81 -0
  100. ads/common/function/__init__.py +5 -0
  101. ads/common/function/fn_util.py +142 -0
  102. ads/common/function/func_conf.yaml +25 -0
  103. ads/common/ipython.py +76 -0
  104. ads/common/model.py +679 -0
  105. ads/common/model_artifact.py +1759 -0
  106. ads/common/model_artifact_schema.json +107 -0
  107. ads/common/model_export_util.py +664 -0
  108. ads/common/model_metadata.py +24 -0
  109. ads/common/object_storage_details.py +296 -0
  110. ads/common/oci_client.py +179 -0
  111. ads/common/oci_datascience.py +46 -0
  112. ads/common/oci_logging.py +1144 -0
  113. ads/common/oci_mixin.py +957 -0
  114. ads/common/oci_resource.py +136 -0
  115. ads/common/serializer.py +559 -0
  116. ads/common/utils.py +1852 -0
  117. ads/common/word_lists.py +1491 -0
  118. ads/common/work_request.py +189 -0
  119. ads/config.py +1 -0
  120. ads/data_labeling/__init__.py +13 -0
  121. ads/data_labeling/boundingbox.py +253 -0
  122. ads/data_labeling/constants.py +47 -0
  123. ads/data_labeling/data_labeling_service.py +244 -0
  124. ads/data_labeling/interface/__init__.py +5 -0
  125. ads/data_labeling/interface/loader.py +16 -0
  126. ads/data_labeling/interface/parser.py +16 -0
  127. ads/data_labeling/interface/reader.py +23 -0
  128. ads/data_labeling/loader/__init__.py +5 -0
  129. ads/data_labeling/loader/file_loader.py +241 -0
  130. ads/data_labeling/metadata.py +110 -0
  131. ads/data_labeling/mixin/__init__.py +5 -0
  132. ads/data_labeling/mixin/data_labeling.py +232 -0
  133. ads/data_labeling/ner.py +129 -0
  134. ads/data_labeling/parser/__init__.py +5 -0
  135. ads/data_labeling/parser/dls_record_parser.py +388 -0
  136. ads/data_labeling/parser/export_metadata_parser.py +94 -0
  137. ads/data_labeling/parser/export_record_parser.py +473 -0
  138. ads/data_labeling/reader/__init__.py +5 -0
  139. ads/data_labeling/reader/dataset_reader.py +574 -0
  140. ads/data_labeling/reader/dls_record_reader.py +121 -0
  141. ads/data_labeling/reader/export_record_reader.py +62 -0
  142. ads/data_labeling/reader/jsonl_reader.py +75 -0
  143. ads/data_labeling/reader/metadata_reader.py +203 -0
  144. ads/data_labeling/reader/record_reader.py +263 -0
  145. ads/data_labeling/record.py +52 -0
  146. ads/data_labeling/visualizer/__init__.py +5 -0
  147. ads/data_labeling/visualizer/image_visualizer.py +525 -0
  148. ads/data_labeling/visualizer/text_visualizer.py +357 -0
  149. ads/database/__init__.py +5 -0
  150. ads/database/connection.py +338 -0
  151. ads/dataset/__init__.py +10 -0
  152. ads/dataset/capabilities.md +51 -0
  153. ads/dataset/classification_dataset.py +339 -0
  154. ads/dataset/correlation.py +226 -0
  155. ads/dataset/correlation_plot.py +563 -0
  156. ads/dataset/dask_series.py +173 -0
  157. ads/dataset/dataframe_transformer.py +110 -0
  158. ads/dataset/dataset.py +1979 -0
  159. ads/dataset/dataset_browser.py +360 -0
  160. ads/dataset/dataset_with_target.py +995 -0
  161. ads/dataset/exception.py +25 -0
  162. ads/dataset/factory.py +987 -0
  163. ads/dataset/feature_engineering_transformer.py +35 -0
  164. ads/dataset/feature_selection.py +107 -0
  165. ads/dataset/forecasting_dataset.py +26 -0
  166. ads/dataset/helper.py +1450 -0
  167. ads/dataset/label_encoder.py +99 -0
  168. ads/dataset/mixin/__init__.py +5 -0
  169. ads/dataset/mixin/dataset_accessor.py +134 -0
  170. ads/dataset/pipeline.py +58 -0
  171. ads/dataset/plot.py +710 -0
  172. ads/dataset/progress.py +86 -0
  173. ads/dataset/recommendation.py +297 -0
  174. ads/dataset/recommendation_transformer.py +502 -0
  175. ads/dataset/regression_dataset.py +14 -0
  176. ads/dataset/sampled_dataset.py +1050 -0
  177. ads/dataset/target.py +98 -0
  178. ads/dataset/timeseries.py +18 -0
  179. ads/dbmixin/__init__.py +5 -0
  180. ads/dbmixin/db_pandas_accessor.py +153 -0
  181. ads/environment/__init__.py +9 -0
  182. ads/environment/ml_runtime.py +66 -0
  183. ads/evaluations/README.md +14 -0
  184. ads/evaluations/__init__.py +109 -0
  185. ads/evaluations/evaluation_plot.py +983 -0
  186. ads/evaluations/evaluator.py +1334 -0
  187. ads/evaluations/statistical_metrics.py +543 -0
  188. ads/experiments/__init__.py +9 -0
  189. ads/experiments/capabilities.md +0 -0
  190. ads/explanations/__init__.py +21 -0
  191. ads/explanations/base_explainer.py +142 -0
  192. ads/explanations/capabilities.md +83 -0
  193. ads/explanations/explainer.py +190 -0
  194. ads/explanations/mlx_global_explainer.py +1050 -0
  195. ads/explanations/mlx_interface.py +386 -0
  196. ads/explanations/mlx_local_explainer.py +287 -0
  197. ads/explanations/mlx_whatif_explainer.py +201 -0
  198. ads/feature_engineering/__init__.py +20 -0
  199. ads/feature_engineering/accessor/__init__.py +5 -0
  200. ads/feature_engineering/accessor/dataframe_accessor.py +535 -0
  201. ads/feature_engineering/accessor/mixin/__init__.py +5 -0
  202. ads/feature_engineering/accessor/mixin/correlation.py +166 -0
  203. ads/feature_engineering/accessor/mixin/eda_mixin.py +266 -0
  204. ads/feature_engineering/accessor/mixin/eda_mixin_series.py +85 -0
  205. ads/feature_engineering/accessor/mixin/feature_types_mixin.py +211 -0
  206. ads/feature_engineering/accessor/mixin/utils.py +65 -0
  207. ads/feature_engineering/accessor/series_accessor.py +431 -0
  208. ads/feature_engineering/adsimage/__init__.py +5 -0
  209. ads/feature_engineering/adsimage/image.py +192 -0
  210. ads/feature_engineering/adsimage/image_reader.py +170 -0
  211. ads/feature_engineering/adsimage/interface/__init__.py +5 -0
  212. ads/feature_engineering/adsimage/interface/reader.py +19 -0
  213. ads/feature_engineering/adsstring/__init__.py +7 -0
  214. ads/feature_engineering/adsstring/oci_language/__init__.py +8 -0
  215. ads/feature_engineering/adsstring/string/__init__.py +8 -0
  216. ads/feature_engineering/data_schema.json +57 -0
  217. ads/feature_engineering/dataset/__init__.py +5 -0
  218. ads/feature_engineering/dataset/zip_code_data.py +42062 -0
  219. ads/feature_engineering/exceptions.py +40 -0
  220. ads/feature_engineering/feature_type/__init__.py +133 -0
  221. ads/feature_engineering/feature_type/address.py +184 -0
  222. ads/feature_engineering/feature_type/adsstring/__init__.py +5 -0
  223. ads/feature_engineering/feature_type/adsstring/common_regex_mixin.py +164 -0
  224. ads/feature_engineering/feature_type/adsstring/oci_language.py +93 -0
  225. ads/feature_engineering/feature_type/adsstring/parsers/__init__.py +5 -0
  226. ads/feature_engineering/feature_type/adsstring/parsers/base.py +47 -0
  227. ads/feature_engineering/feature_type/adsstring/parsers/nltk_parser.py +96 -0
  228. ads/feature_engineering/feature_type/adsstring/parsers/spacy_parser.py +221 -0
  229. ads/feature_engineering/feature_type/adsstring/string.py +258 -0
  230. ads/feature_engineering/feature_type/base.py +58 -0
  231. ads/feature_engineering/feature_type/boolean.py +183 -0
  232. ads/feature_engineering/feature_type/category.py +146 -0
  233. ads/feature_engineering/feature_type/constant.py +137 -0
  234. ads/feature_engineering/feature_type/continuous.py +151 -0
  235. ads/feature_engineering/feature_type/creditcard.py +314 -0
  236. ads/feature_engineering/feature_type/datetime.py +190 -0
  237. ads/feature_engineering/feature_type/discrete.py +134 -0
  238. ads/feature_engineering/feature_type/document.py +43 -0
  239. ads/feature_engineering/feature_type/gis.py +251 -0
  240. ads/feature_engineering/feature_type/handler/__init__.py +5 -0
  241. ads/feature_engineering/feature_type/handler/feature_validator.py +524 -0
  242. ads/feature_engineering/feature_type/handler/feature_warning.py +319 -0
  243. ads/feature_engineering/feature_type/handler/warnings.py +128 -0
  244. ads/feature_engineering/feature_type/integer.py +142 -0
  245. ads/feature_engineering/feature_type/ip_address.py +144 -0
  246. ads/feature_engineering/feature_type/ip_address_v4.py +138 -0
  247. ads/feature_engineering/feature_type/ip_address_v6.py +138 -0
  248. ads/feature_engineering/feature_type/lat_long.py +256 -0
  249. ads/feature_engineering/feature_type/object.py +43 -0
  250. ads/feature_engineering/feature_type/ordinal.py +132 -0
  251. ads/feature_engineering/feature_type/phone_number.py +135 -0
  252. ads/feature_engineering/feature_type/string.py +171 -0
  253. ads/feature_engineering/feature_type/text.py +93 -0
  254. ads/feature_engineering/feature_type/unknown.py +43 -0
  255. ads/feature_engineering/feature_type/zip_code.py +164 -0
  256. ads/feature_engineering/feature_type_manager.py +406 -0
  257. ads/feature_engineering/schema.py +795 -0
  258. ads/feature_engineering/utils.py +245 -0
  259. ads/feature_store/.readthedocs.yaml +19 -0
  260. ads/feature_store/README.md +65 -0
  261. ads/feature_store/__init__.py +9 -0
  262. ads/feature_store/common/__init__.py +0 -0
  263. ads/feature_store/common/enums.py +339 -0
  264. ads/feature_store/common/exceptions.py +18 -0
  265. ads/feature_store/common/spark_session_singleton.py +125 -0
  266. ads/feature_store/common/utils/__init__.py +0 -0
  267. ads/feature_store/common/utils/base64_encoder_decoder.py +72 -0
  268. ads/feature_store/common/utils/feature_schema_mapper.py +283 -0
  269. ads/feature_store/common/utils/transformation_utils.py +82 -0
  270. ads/feature_store/common/utils/utility.py +403 -0
  271. ads/feature_store/data_validation/__init__.py +0 -0
  272. ads/feature_store/data_validation/great_expectation.py +129 -0
  273. ads/feature_store/dataset.py +1230 -0
  274. ads/feature_store/dataset_job.py +530 -0
  275. ads/feature_store/docs/Dockerfile +7 -0
  276. ads/feature_store/docs/Makefile +44 -0
  277. ads/feature_store/docs/conf.py +28 -0
  278. ads/feature_store/docs/requirements.txt +14 -0
  279. ads/feature_store/docs/source/ads.feature_store.query.rst +20 -0
  280. ads/feature_store/docs/source/cicd.rst +137 -0
  281. ads/feature_store/docs/source/conf.py +86 -0
  282. ads/feature_store/docs/source/data_versioning.rst +33 -0
  283. ads/feature_store/docs/source/dataset.rst +388 -0
  284. ads/feature_store/docs/source/dataset_job.rst +27 -0
  285. ads/feature_store/docs/source/demo.rst +70 -0
  286. ads/feature_store/docs/source/entity.rst +78 -0
  287. ads/feature_store/docs/source/feature_group.rst +624 -0
  288. ads/feature_store/docs/source/feature_group_job.rst +29 -0
  289. ads/feature_store/docs/source/feature_store.rst +122 -0
  290. ads/feature_store/docs/source/feature_store_class.rst +123 -0
  291. ads/feature_store/docs/source/feature_validation.rst +66 -0
  292. ads/feature_store/docs/source/figures/cicd.png +0 -0
  293. ads/feature_store/docs/source/figures/data_validation.png +0 -0
  294. ads/feature_store/docs/source/figures/data_versioning.png +0 -0
  295. ads/feature_store/docs/source/figures/dataset.gif +0 -0
  296. ads/feature_store/docs/source/figures/dataset.png +0 -0
  297. ads/feature_store/docs/source/figures/dataset_lineage.png +0 -0
  298. ads/feature_store/docs/source/figures/dataset_statistics.png +0 -0
  299. ads/feature_store/docs/source/figures/dataset_statistics_viz.png +0 -0
  300. ads/feature_store/docs/source/figures/dataset_validation_results.png +0 -0
  301. ads/feature_store/docs/source/figures/dataset_validation_summary.png +0 -0
  302. ads/feature_store/docs/source/figures/drift_monitoring.png +0 -0
  303. ads/feature_store/docs/source/figures/entity.png +0 -0
  304. ads/feature_store/docs/source/figures/feature_group.png +0 -0
  305. ads/feature_store/docs/source/figures/feature_group_lineage.png +0 -0
  306. ads/feature_store/docs/source/figures/feature_group_statistics_viz.png +0 -0
  307. ads/feature_store/docs/source/figures/feature_store_deployment.png +0 -0
  308. ads/feature_store/docs/source/figures/feature_store_overview.png +0 -0
  309. ads/feature_store/docs/source/figures/featuregroup.gif +0 -0
  310. ads/feature_store/docs/source/figures/lineage_d1.png +0 -0
  311. ads/feature_store/docs/source/figures/lineage_d2.png +0 -0
  312. ads/feature_store/docs/source/figures/lineage_fg.png +0 -0
  313. ads/feature_store/docs/source/figures/logo-dark-mode.png +0 -0
  314. ads/feature_store/docs/source/figures/logo-light-mode.png +0 -0
  315. ads/feature_store/docs/source/figures/overview.png +0 -0
  316. ads/feature_store/docs/source/figures/resource_manager.png +0 -0
  317. ads/feature_store/docs/source/figures/resource_manager_feature_store_stack.png +0 -0
  318. ads/feature_store/docs/source/figures/resource_manager_home.png +0 -0
  319. ads/feature_store/docs/source/figures/stats_1.png +0 -0
  320. ads/feature_store/docs/source/figures/stats_2.png +0 -0
  321. ads/feature_store/docs/source/figures/stats_d.png +0 -0
  322. ads/feature_store/docs/source/figures/stats_fg.png +0 -0
  323. ads/feature_store/docs/source/figures/transformation.png +0 -0
  324. ads/feature_store/docs/source/figures/transformations.gif +0 -0
  325. ads/feature_store/docs/source/figures/validation.png +0 -0
  326. ads/feature_store/docs/source/figures/validation_fg.png +0 -0
  327. ads/feature_store/docs/source/figures/validation_results.png +0 -0
  328. ads/feature_store/docs/source/figures/validation_summary.png +0 -0
  329. ads/feature_store/docs/source/index.rst +81 -0
  330. ads/feature_store/docs/source/module.rst +8 -0
  331. ads/feature_store/docs/source/notebook.rst +94 -0
  332. ads/feature_store/docs/source/overview.rst +47 -0
  333. ads/feature_store/docs/source/quickstart.rst +176 -0
  334. ads/feature_store/docs/source/release_notes.rst +194 -0
  335. ads/feature_store/docs/source/setup_feature_store.rst +81 -0
  336. ads/feature_store/docs/source/statistics.rst +58 -0
  337. ads/feature_store/docs/source/transformation.rst +199 -0
  338. ads/feature_store/docs/source/ui.rst +65 -0
  339. ads/feature_store/docs/source/user_guides.setup.feature_store_operator.rst +66 -0
  340. ads/feature_store/docs/source/user_guides.setup.helm_chart.rst +192 -0
  341. ads/feature_store/docs/source/user_guides.setup.terraform.rst +338 -0
  342. ads/feature_store/entity.py +718 -0
  343. ads/feature_store/execution_strategy/__init__.py +0 -0
  344. ads/feature_store/execution_strategy/delta_lake/__init__.py +0 -0
  345. ads/feature_store/execution_strategy/delta_lake/delta_lake_service.py +375 -0
  346. ads/feature_store/execution_strategy/engine/__init__.py +0 -0
  347. ads/feature_store/execution_strategy/engine/spark_engine.py +316 -0
  348. ads/feature_store/execution_strategy/execution_strategy.py +113 -0
  349. ads/feature_store/execution_strategy/execution_strategy_provider.py +47 -0
  350. ads/feature_store/execution_strategy/spark/__init__.py +0 -0
  351. ads/feature_store/execution_strategy/spark/spark_execution.py +618 -0
  352. ads/feature_store/feature.py +192 -0
  353. ads/feature_store/feature_group.py +1494 -0
  354. ads/feature_store/feature_group_expectation.py +346 -0
  355. ads/feature_store/feature_group_job.py +602 -0
  356. ads/feature_store/feature_lineage/__init__.py +0 -0
  357. ads/feature_store/feature_lineage/graphviz_service.py +180 -0
  358. ads/feature_store/feature_option_details.py +50 -0
  359. ads/feature_store/feature_statistics/__init__.py +0 -0
  360. ads/feature_store/feature_statistics/statistics_service.py +99 -0
  361. ads/feature_store/feature_store.py +699 -0
  362. ads/feature_store/feature_store_registrar.py +518 -0
  363. ads/feature_store/input_feature_detail.py +149 -0
  364. ads/feature_store/mixin/__init__.py +4 -0
  365. ads/feature_store/mixin/oci_feature_store.py +145 -0
  366. ads/feature_store/model_details.py +73 -0
  367. ads/feature_store/query/__init__.py +0 -0
  368. ads/feature_store/query/filter.py +266 -0
  369. ads/feature_store/query/generator/__init__.py +0 -0
  370. ads/feature_store/query/generator/query_generator.py +298 -0
  371. ads/feature_store/query/join.py +161 -0
  372. ads/feature_store/query/query.py +403 -0
  373. ads/feature_store/query/validator/__init__.py +0 -0
  374. ads/feature_store/query/validator/query_validator.py +57 -0
  375. ads/feature_store/response/__init__.py +0 -0
  376. ads/feature_store/response/response_builder.py +68 -0
  377. ads/feature_store/service/__init__.py +0 -0
  378. ads/feature_store/service/oci_dataset.py +139 -0
  379. ads/feature_store/service/oci_dataset_job.py +199 -0
  380. ads/feature_store/service/oci_entity.py +125 -0
  381. ads/feature_store/service/oci_feature_group.py +164 -0
  382. ads/feature_store/service/oci_feature_group_job.py +214 -0
  383. ads/feature_store/service/oci_feature_store.py +182 -0
  384. ads/feature_store/service/oci_lineage.py +87 -0
  385. ads/feature_store/service/oci_transformation.py +104 -0
  386. ads/feature_store/statistics/__init__.py +0 -0
  387. ads/feature_store/statistics/abs_feature_value.py +49 -0
  388. ads/feature_store/statistics/charts/__init__.py +0 -0
  389. ads/feature_store/statistics/charts/abstract_feature_plot.py +37 -0
  390. ads/feature_store/statistics/charts/box_plot.py +148 -0
  391. ads/feature_store/statistics/charts/frequency_distribution.py +65 -0
  392. ads/feature_store/statistics/charts/probability_distribution.py +68 -0
  393. ads/feature_store/statistics/charts/top_k_frequent_elements.py +98 -0
  394. ads/feature_store/statistics/feature_stat.py +126 -0
  395. ads/feature_store/statistics/generic_feature_value.py +33 -0
  396. ads/feature_store/statistics/statistics.py +41 -0
  397. ads/feature_store/statistics_config.py +101 -0
  398. ads/feature_store/templates/feature_store_template.yaml +45 -0
  399. ads/feature_store/transformation.py +499 -0
  400. ads/feature_store/validation_output.py +57 -0
  401. ads/hpo/__init__.py +9 -0
  402. ads/hpo/_imports.py +91 -0
  403. ads/hpo/ads_search_space.py +439 -0
  404. ads/hpo/distributions.py +325 -0
  405. ads/hpo/objective.py +280 -0
  406. ads/hpo/search_cv.py +1657 -0
  407. ads/hpo/stopping_criterion.py +75 -0
  408. ads/hpo/tuner_artifact.py +413 -0
  409. ads/hpo/utils.py +91 -0
  410. ads/hpo/validation.py +140 -0
  411. ads/hpo/visualization/__init__.py +5 -0
  412. ads/hpo/visualization/_contour.py +23 -0
  413. ads/hpo/visualization/_edf.py +20 -0
  414. ads/hpo/visualization/_intermediate_values.py +21 -0
  415. ads/hpo/visualization/_optimization_history.py +25 -0
  416. ads/hpo/visualization/_parallel_coordinate.py +169 -0
  417. ads/hpo/visualization/_param_importances.py +26 -0
  418. ads/jobs/__init__.py +53 -0
  419. ads/jobs/ads_job.py +663 -0
  420. ads/jobs/builders/__init__.py +5 -0
  421. ads/jobs/builders/base.py +156 -0
  422. ads/jobs/builders/infrastructure/__init__.py +6 -0
  423. ads/jobs/builders/infrastructure/base.py +165 -0
  424. ads/jobs/builders/infrastructure/dataflow.py +1252 -0
  425. ads/jobs/builders/infrastructure/dsc_job.py +1894 -0
  426. ads/jobs/builders/infrastructure/dsc_job_runtime.py +1233 -0
  427. ads/jobs/builders/infrastructure/utils.py +65 -0
  428. ads/jobs/builders/runtimes/__init__.py +5 -0
  429. ads/jobs/builders/runtimes/artifact.py +338 -0
  430. ads/jobs/builders/runtimes/base.py +325 -0
  431. ads/jobs/builders/runtimes/container_runtime.py +242 -0
  432. ads/jobs/builders/runtimes/python_runtime.py +1016 -0
  433. ads/jobs/builders/runtimes/pytorch_runtime.py +204 -0
  434. ads/jobs/cli.py +104 -0
  435. ads/jobs/env_var_parser.py +131 -0
  436. ads/jobs/extension.py +160 -0
  437. ads/jobs/schema/__init__.py +5 -0
  438. ads/jobs/schema/infrastructure_schema.json +116 -0
  439. ads/jobs/schema/job_schema.json +42 -0
  440. ads/jobs/schema/runtime_schema.json +183 -0
  441. ads/jobs/schema/validator.py +141 -0
  442. ads/jobs/serializer.py +296 -0
  443. ads/jobs/templates/__init__.py +5 -0
  444. ads/jobs/templates/container.py +6 -0
  445. ads/jobs/templates/driver_notebook.py +177 -0
  446. ads/jobs/templates/driver_oci.py +500 -0
  447. ads/jobs/templates/driver_python.py +48 -0
  448. ads/jobs/templates/driver_pytorch.py +852 -0
  449. ads/jobs/templates/driver_utils.py +615 -0
  450. ads/jobs/templates/hostname_from_env.c +55 -0
  451. ads/jobs/templates/oci_metrics.py +181 -0
  452. ads/jobs/utils.py +104 -0
  453. ads/llm/__init__.py +28 -0
  454. ads/llm/autogen/__init__.py +2 -0
  455. ads/llm/autogen/constants.py +15 -0
  456. ads/llm/autogen/reports/__init__.py +2 -0
  457. ads/llm/autogen/reports/base.py +67 -0
  458. ads/llm/autogen/reports/data.py +103 -0
  459. ads/llm/autogen/reports/session.py +526 -0
  460. ads/llm/autogen/reports/templates/chat_box.html +13 -0
  461. ads/llm/autogen/reports/templates/chat_box_lt.html +5 -0
  462. ads/llm/autogen/reports/templates/chat_box_rt.html +6 -0
  463. ads/llm/autogen/reports/utils.py +56 -0
  464. ads/llm/autogen/v02/__init__.py +4 -0
  465. ads/llm/autogen/v02/client.py +295 -0
  466. ads/llm/autogen/v02/log_handlers/__init__.py +2 -0
  467. ads/llm/autogen/v02/log_handlers/oci_file_handler.py +83 -0
  468. ads/llm/autogen/v02/loggers/__init__.py +6 -0
  469. ads/llm/autogen/v02/loggers/metric_logger.py +320 -0
  470. ads/llm/autogen/v02/loggers/session_logger.py +580 -0
  471. ads/llm/autogen/v02/loggers/utils.py +86 -0
  472. ads/llm/autogen/v02/runtime_logging.py +163 -0
  473. ads/llm/chain.py +268 -0
  474. ads/llm/chat_template.py +31 -0
  475. ads/llm/deploy.py +63 -0
  476. ads/llm/guardrails/__init__.py +5 -0
  477. ads/llm/guardrails/base.py +442 -0
  478. ads/llm/guardrails/huggingface.py +44 -0
  479. ads/llm/langchain/__init__.py +5 -0
  480. ads/llm/langchain/plugins/__init__.py +5 -0
  481. ads/llm/langchain/plugins/chat_models/__init__.py +5 -0
  482. ads/llm/langchain/plugins/chat_models/oci_data_science.py +1027 -0
  483. ads/llm/langchain/plugins/embeddings/__init__.py +4 -0
  484. ads/llm/langchain/plugins/embeddings/oci_data_science_model_deployment_endpoint.py +184 -0
  485. ads/llm/langchain/plugins/llms/__init__.py +5 -0
  486. ads/llm/langchain/plugins/llms/oci_data_science_model_deployment_endpoint.py +979 -0
  487. ads/llm/requirements.txt +3 -0
  488. ads/llm/serialize.py +219 -0
  489. ads/llm/serializers/__init__.py +0 -0
  490. ads/llm/serializers/retrieval_qa.py +153 -0
  491. ads/llm/serializers/runnable_parallel.py +27 -0
  492. ads/llm/templates/score_chain.jinja2 +155 -0
  493. ads/llm/templates/tool_chat_template_hermes.jinja +130 -0
  494. ads/llm/templates/tool_chat_template_mistral_parallel.jinja +94 -0
  495. ads/model/__init__.py +52 -0
  496. ads/model/artifact.py +573 -0
  497. ads/model/artifact_downloader.py +254 -0
  498. ads/model/artifact_uploader.py +267 -0
  499. ads/model/base_properties.py +238 -0
  500. ads/model/common/.model-ignore +66 -0
  501. ads/model/common/__init__.py +5 -0
  502. ads/model/common/utils.py +142 -0
  503. ads/model/datascience_model.py +2635 -0
  504. ads/model/deployment/__init__.py +20 -0
  505. ads/model/deployment/common/__init__.py +5 -0
  506. ads/model/deployment/common/utils.py +308 -0
  507. ads/model/deployment/model_deployer.py +466 -0
  508. ads/model/deployment/model_deployment.py +1846 -0
  509. ads/model/deployment/model_deployment_infrastructure.py +671 -0
  510. ads/model/deployment/model_deployment_properties.py +493 -0
  511. ads/model/deployment/model_deployment_runtime.py +838 -0
  512. ads/model/extractor/__init__.py +5 -0
  513. ads/model/extractor/automl_extractor.py +74 -0
  514. ads/model/extractor/embedding_onnx_extractor.py +80 -0
  515. ads/model/extractor/huggingface_extractor.py +88 -0
  516. ads/model/extractor/keras_extractor.py +84 -0
  517. ads/model/extractor/lightgbm_extractor.py +93 -0
  518. ads/model/extractor/model_info_extractor.py +114 -0
  519. ads/model/extractor/model_info_extractor_factory.py +105 -0
  520. ads/model/extractor/pytorch_extractor.py +87 -0
  521. ads/model/extractor/sklearn_extractor.py +112 -0
  522. ads/model/extractor/spark_extractor.py +89 -0
  523. ads/model/extractor/tensorflow_extractor.py +85 -0
  524. ads/model/extractor/xgboost_extractor.py +94 -0
  525. ads/model/framework/__init__.py +5 -0
  526. ads/model/framework/automl_model.py +178 -0
  527. ads/model/framework/embedding_onnx_model.py +438 -0
  528. ads/model/framework/huggingface_model.py +399 -0
  529. ads/model/framework/lightgbm_model.py +266 -0
  530. ads/model/framework/pytorch_model.py +266 -0
  531. ads/model/framework/sklearn_model.py +250 -0
  532. ads/model/framework/spark_model.py +326 -0
  533. ads/model/framework/tensorflow_model.py +254 -0
  534. ads/model/framework/xgboost_model.py +258 -0
  535. ads/model/generic_model.py +3518 -0
  536. ads/model/model_artifact_boilerplate/README.md +381 -0
  537. ads/model/model_artifact_boilerplate/__init__.py +5 -0
  538. ads/model/model_artifact_boilerplate/artifact_introspection_test/__init__.py +5 -0
  539. ads/model/model_artifact_boilerplate/artifact_introspection_test/model_artifact_validate.py +427 -0
  540. ads/model/model_artifact_boilerplate/artifact_introspection_test/requirements.txt +2 -0
  541. ads/model/model_artifact_boilerplate/runtime.yaml +7 -0
  542. ads/model/model_artifact_boilerplate/score.py +61 -0
  543. ads/model/model_file_description_schema.json +68 -0
  544. ads/model/model_introspect.py +331 -0
  545. ads/model/model_metadata.py +1810 -0
  546. ads/model/model_metadata_mixin.py +460 -0
  547. ads/model/model_properties.py +63 -0
  548. ads/model/model_version_set.py +739 -0
  549. ads/model/runtime/__init__.py +5 -0
  550. ads/model/runtime/env_info.py +306 -0
  551. ads/model/runtime/model_deployment_details.py +37 -0
  552. ads/model/runtime/model_provenance_details.py +58 -0
  553. ads/model/runtime/runtime_info.py +81 -0
  554. ads/model/runtime/schemas/inference_env_info_schema.yaml +16 -0
  555. ads/model/runtime/schemas/model_provenance_schema.yaml +36 -0
  556. ads/model/runtime/schemas/training_env_info_schema.yaml +16 -0
  557. ads/model/runtime/utils.py +201 -0
  558. ads/model/serde/__init__.py +5 -0
  559. ads/model/serde/common.py +40 -0
  560. ads/model/serde/model_input.py +547 -0
  561. ads/model/serde/model_serializer.py +1184 -0
  562. ads/model/service/__init__.py +5 -0
  563. ads/model/service/oci_datascience_model.py +1076 -0
  564. ads/model/service/oci_datascience_model_deployment.py +500 -0
  565. ads/model/service/oci_datascience_model_version_set.py +176 -0
  566. ads/model/transformer/__init__.py +5 -0
  567. ads/model/transformer/onnx_transformer.py +324 -0
  568. ads/mysqldb/__init__.py +5 -0
  569. ads/mysqldb/mysql_db.py +227 -0
  570. ads/opctl/__init__.py +18 -0
  571. ads/opctl/anomaly_detection.py +11 -0
  572. ads/opctl/backend/__init__.py +5 -0
  573. ads/opctl/backend/ads_dataflow.py +353 -0
  574. ads/opctl/backend/ads_ml_job.py +710 -0
  575. ads/opctl/backend/ads_ml_pipeline.py +164 -0
  576. ads/opctl/backend/ads_model_deployment.py +209 -0
  577. ads/opctl/backend/base.py +146 -0
  578. ads/opctl/backend/local.py +1053 -0
  579. ads/opctl/backend/marketplace/__init__.py +9 -0
  580. ads/opctl/backend/marketplace/helm_helper.py +173 -0
  581. ads/opctl/backend/marketplace/local_marketplace.py +271 -0
  582. ads/opctl/backend/marketplace/marketplace_backend_runner.py +71 -0
  583. ads/opctl/backend/marketplace/marketplace_operator_interface.py +44 -0
  584. ads/opctl/backend/marketplace/marketplace_operator_runner.py +24 -0
  585. ads/opctl/backend/marketplace/marketplace_utils.py +212 -0
  586. ads/opctl/backend/marketplace/models/__init__.py +5 -0
  587. ads/opctl/backend/marketplace/models/bearer_token.py +94 -0
  588. ads/opctl/backend/marketplace/models/marketplace_type.py +70 -0
  589. ads/opctl/backend/marketplace/models/ocir_details.py +56 -0
  590. ads/opctl/backend/marketplace/prerequisite_checker.py +238 -0
  591. ads/opctl/cli.py +707 -0
  592. ads/opctl/cmds.py +869 -0
  593. ads/opctl/conda/__init__.py +5 -0
  594. ads/opctl/conda/cli.py +193 -0
  595. ads/opctl/conda/cmds.py +749 -0
  596. ads/opctl/conda/config.yaml +34 -0
  597. ads/opctl/conda/manifest_template.yaml +13 -0
  598. ads/opctl/conda/multipart_uploader.py +188 -0
  599. ads/opctl/conda/pack.py +89 -0
  600. ads/opctl/config/__init__.py +5 -0
  601. ads/opctl/config/base.py +57 -0
  602. ads/opctl/config/diagnostics/__init__.py +5 -0
  603. ads/opctl/config/diagnostics/distributed/default_requirements_config.yaml +62 -0
  604. ads/opctl/config/merger.py +255 -0
  605. ads/opctl/config/resolver.py +297 -0
  606. ads/opctl/config/utils.py +79 -0
  607. ads/opctl/config/validator.py +17 -0
  608. ads/opctl/config/versioner.py +68 -0
  609. ads/opctl/config/yaml_parsers/__init__.py +7 -0
  610. ads/opctl/config/yaml_parsers/base.py +58 -0
  611. ads/opctl/config/yaml_parsers/distributed/__init__.py +7 -0
  612. ads/opctl/config/yaml_parsers/distributed/yaml_parser.py +201 -0
  613. ads/opctl/constants.py +66 -0
  614. ads/opctl/decorator/__init__.py +5 -0
  615. ads/opctl/decorator/common.py +129 -0
  616. ads/opctl/diagnostics/__init__.py +5 -0
  617. ads/opctl/diagnostics/__main__.py +25 -0
  618. ads/opctl/diagnostics/check_distributed_job_requirements.py +212 -0
  619. ads/opctl/diagnostics/check_requirements.py +144 -0
  620. ads/opctl/diagnostics/requirement_exception.py +9 -0
  621. ads/opctl/distributed/README.md +109 -0
  622. ads/opctl/distributed/__init__.py +5 -0
  623. ads/opctl/distributed/certificates.py +32 -0
  624. ads/opctl/distributed/cli.py +207 -0
  625. ads/opctl/distributed/cmds.py +731 -0
  626. ads/opctl/distributed/common/__init__.py +5 -0
  627. ads/opctl/distributed/common/abstract_cluster_provider.py +449 -0
  628. ads/opctl/distributed/common/abstract_framework_spec_builder.py +88 -0
  629. ads/opctl/distributed/common/cluster_config_helper.py +103 -0
  630. ads/opctl/distributed/common/cluster_provider_factory.py +21 -0
  631. ads/opctl/distributed/common/cluster_runner.py +54 -0
  632. ads/opctl/distributed/common/framework_factory.py +29 -0
  633. ads/opctl/docker/Dockerfile.job +103 -0
  634. ads/opctl/docker/Dockerfile.job.arm +107 -0
  635. ads/opctl/docker/Dockerfile.job.gpu +175 -0
  636. ads/opctl/docker/base-env.yaml +13 -0
  637. ads/opctl/docker/cuda.repo +6 -0
  638. ads/opctl/docker/operator/.dockerignore +0 -0
  639. ads/opctl/docker/operator/Dockerfile +41 -0
  640. ads/opctl/docker/operator/Dockerfile.gpu +85 -0
  641. ads/opctl/docker/operator/cuda.repo +6 -0
  642. ads/opctl/docker/operator/environment.yaml +8 -0
  643. ads/opctl/forecast.py +11 -0
  644. ads/opctl/index.yaml +3 -0
  645. ads/opctl/model/__init__.py +5 -0
  646. ads/opctl/model/cli.py +65 -0
  647. ads/opctl/model/cmds.py +73 -0
  648. ads/opctl/operator/README.md +4 -0
  649. ads/opctl/operator/__init__.py +31 -0
  650. ads/opctl/operator/cli.py +344 -0
  651. ads/opctl/operator/cmd.py +596 -0
  652. ads/opctl/operator/common/__init__.py +5 -0
  653. ads/opctl/operator/common/backend_factory.py +460 -0
  654. ads/opctl/operator/common/const.py +27 -0
  655. ads/opctl/operator/common/data/synthetic.csv +16001 -0
  656. ads/opctl/operator/common/dictionary_merger.py +148 -0
  657. ads/opctl/operator/common/errors.py +42 -0
  658. ads/opctl/operator/common/operator_config.py +99 -0
  659. ads/opctl/operator/common/operator_loader.py +811 -0
  660. ads/opctl/operator/common/operator_schema.yaml +130 -0
  661. ads/opctl/operator/common/operator_yaml_generator.py +152 -0
  662. ads/opctl/operator/common/utils.py +208 -0
  663. ads/opctl/operator/lowcode/__init__.py +5 -0
  664. ads/opctl/operator/lowcode/anomaly/MLoperator +16 -0
  665. ads/opctl/operator/lowcode/anomaly/README.md +207 -0
  666. ads/opctl/operator/lowcode/anomaly/__init__.py +5 -0
  667. ads/opctl/operator/lowcode/anomaly/__main__.py +103 -0
  668. ads/opctl/operator/lowcode/anomaly/cmd.py +35 -0
  669. ads/opctl/operator/lowcode/anomaly/const.py +167 -0
  670. ads/opctl/operator/lowcode/anomaly/environment.yaml +10 -0
  671. ads/opctl/operator/lowcode/anomaly/model/__init__.py +5 -0
  672. ads/opctl/operator/lowcode/anomaly/model/anomaly_dataset.py +146 -0
  673. ads/opctl/operator/lowcode/anomaly/model/anomaly_merlion.py +162 -0
  674. ads/opctl/operator/lowcode/anomaly/model/automlx.py +99 -0
  675. ads/opctl/operator/lowcode/anomaly/model/autots.py +115 -0
  676. ads/opctl/operator/lowcode/anomaly/model/base_model.py +404 -0
  677. ads/opctl/operator/lowcode/anomaly/model/factory.py +110 -0
  678. ads/opctl/operator/lowcode/anomaly/model/isolationforest.py +78 -0
  679. ads/opctl/operator/lowcode/anomaly/model/oneclasssvm.py +78 -0
  680. ads/opctl/operator/lowcode/anomaly/model/randomcutforest.py +120 -0
  681. ads/opctl/operator/lowcode/anomaly/model/tods.py +119 -0
  682. ads/opctl/operator/lowcode/anomaly/operator_config.py +127 -0
  683. ads/opctl/operator/lowcode/anomaly/schema.yaml +401 -0
  684. ads/opctl/operator/lowcode/anomaly/utils.py +88 -0
  685. ads/opctl/operator/lowcode/common/__init__.py +5 -0
  686. ads/opctl/operator/lowcode/common/const.py +10 -0
  687. ads/opctl/operator/lowcode/common/data.py +116 -0
  688. ads/opctl/operator/lowcode/common/errors.py +47 -0
  689. ads/opctl/operator/lowcode/common/transformations.py +296 -0
  690. ads/opctl/operator/lowcode/common/utils.py +384 -0
  691. ads/opctl/operator/lowcode/feature_store_marketplace/MLoperator +13 -0
  692. ads/opctl/operator/lowcode/feature_store_marketplace/README.md +30 -0
  693. ads/opctl/operator/lowcode/feature_store_marketplace/__init__.py +5 -0
  694. ads/opctl/operator/lowcode/feature_store_marketplace/__main__.py +116 -0
  695. ads/opctl/operator/lowcode/feature_store_marketplace/cmd.py +85 -0
  696. ads/opctl/operator/lowcode/feature_store_marketplace/const.py +15 -0
  697. ads/opctl/operator/lowcode/feature_store_marketplace/environment.yaml +0 -0
  698. ads/opctl/operator/lowcode/feature_store_marketplace/models/__init__.py +4 -0
  699. ads/opctl/operator/lowcode/feature_store_marketplace/models/apigw_config.py +32 -0
  700. ads/opctl/operator/lowcode/feature_store_marketplace/models/db_config.py +43 -0
  701. ads/opctl/operator/lowcode/feature_store_marketplace/models/mysql_config.py +120 -0
  702. ads/opctl/operator/lowcode/feature_store_marketplace/models/serializable_yaml_model.py +34 -0
  703. ads/opctl/operator/lowcode/feature_store_marketplace/operator_utils.py +386 -0
  704. ads/opctl/operator/lowcode/feature_store_marketplace/schema.yaml +160 -0
  705. ads/opctl/operator/lowcode/forecast/MLoperator +25 -0
  706. ads/opctl/operator/lowcode/forecast/README.md +209 -0
  707. ads/opctl/operator/lowcode/forecast/__init__.py +5 -0
  708. ads/opctl/operator/lowcode/forecast/__main__.py +89 -0
  709. ads/opctl/operator/lowcode/forecast/cmd.py +40 -0
  710. ads/opctl/operator/lowcode/forecast/const.py +92 -0
  711. ads/opctl/operator/lowcode/forecast/environment.yaml +20 -0
  712. ads/opctl/operator/lowcode/forecast/errors.py +26 -0
  713. ads/opctl/operator/lowcode/forecast/model/__init__.py +5 -0
  714. ads/opctl/operator/lowcode/forecast/model/arima.py +279 -0
  715. ads/opctl/operator/lowcode/forecast/model/automlx.py +553 -0
  716. ads/opctl/operator/lowcode/forecast/model/autots.py +312 -0
  717. ads/opctl/operator/lowcode/forecast/model/base_model.py +875 -0
  718. ads/opctl/operator/lowcode/forecast/model/factory.py +106 -0
  719. ads/opctl/operator/lowcode/forecast/model/forecast_datasets.py +492 -0
  720. ads/opctl/operator/lowcode/forecast/model/ml_forecast.py +243 -0
  721. ads/opctl/operator/lowcode/forecast/model/neuralprophet.py +482 -0
  722. ads/opctl/operator/lowcode/forecast/model/prophet.py +450 -0
  723. ads/opctl/operator/lowcode/forecast/model_evaluator.py +244 -0
  724. ads/opctl/operator/lowcode/forecast/operator_config.py +234 -0
  725. ads/opctl/operator/lowcode/forecast/schema.yaml +506 -0
  726. ads/opctl/operator/lowcode/forecast/utils.py +397 -0
  727. ads/opctl/operator/lowcode/forecast/whatifserve/__init__.py +7 -0
  728. ads/opctl/operator/lowcode/forecast/whatifserve/deployment_manager.py +285 -0
  729. ads/opctl/operator/lowcode/forecast/whatifserve/score.py +246 -0
  730. ads/opctl/operator/lowcode/pii/MLoperator +17 -0
  731. ads/opctl/operator/lowcode/pii/README.md +208 -0
  732. ads/opctl/operator/lowcode/pii/__init__.py +5 -0
  733. ads/opctl/operator/lowcode/pii/__main__.py +78 -0
  734. ads/opctl/operator/lowcode/pii/cmd.py +39 -0
  735. ads/opctl/operator/lowcode/pii/constant.py +84 -0
  736. ads/opctl/operator/lowcode/pii/environment.yaml +17 -0
  737. ads/opctl/operator/lowcode/pii/errors.py +27 -0
  738. ads/opctl/operator/lowcode/pii/model/__init__.py +5 -0
  739. ads/opctl/operator/lowcode/pii/model/factory.py +82 -0
  740. ads/opctl/operator/lowcode/pii/model/guardrails.py +167 -0
  741. ads/opctl/operator/lowcode/pii/model/pii.py +145 -0
  742. ads/opctl/operator/lowcode/pii/model/processor/__init__.py +34 -0
  743. ads/opctl/operator/lowcode/pii/model/processor/email_replacer.py +34 -0
  744. ads/opctl/operator/lowcode/pii/model/processor/mbi_replacer.py +35 -0
  745. ads/opctl/operator/lowcode/pii/model/processor/name_replacer.py +225 -0
  746. ads/opctl/operator/lowcode/pii/model/processor/number_replacer.py +73 -0
  747. ads/opctl/operator/lowcode/pii/model/processor/remover.py +26 -0
  748. ads/opctl/operator/lowcode/pii/model/report.py +487 -0
  749. ads/opctl/operator/lowcode/pii/operator_config.py +95 -0
  750. ads/opctl/operator/lowcode/pii/schema.yaml +108 -0
  751. ads/opctl/operator/lowcode/pii/utils.py +43 -0
  752. ads/opctl/operator/lowcode/recommender/MLoperator +16 -0
  753. ads/opctl/operator/lowcode/recommender/README.md +206 -0
  754. ads/opctl/operator/lowcode/recommender/__init__.py +5 -0
  755. ads/opctl/operator/lowcode/recommender/__main__.py +82 -0
  756. ads/opctl/operator/lowcode/recommender/cmd.py +33 -0
  757. ads/opctl/operator/lowcode/recommender/constant.py +30 -0
  758. ads/opctl/operator/lowcode/recommender/environment.yaml +11 -0
  759. ads/opctl/operator/lowcode/recommender/model/base_model.py +212 -0
  760. ads/opctl/operator/lowcode/recommender/model/factory.py +56 -0
  761. ads/opctl/operator/lowcode/recommender/model/recommender_dataset.py +25 -0
  762. ads/opctl/operator/lowcode/recommender/model/svd.py +106 -0
  763. ads/opctl/operator/lowcode/recommender/operator_config.py +81 -0
  764. ads/opctl/operator/lowcode/recommender/schema.yaml +265 -0
  765. ads/opctl/operator/lowcode/recommender/utils.py +13 -0
  766. ads/opctl/operator/runtime/__init__.py +5 -0
  767. ads/opctl/operator/runtime/const.py +17 -0
  768. ads/opctl/operator/runtime/container_runtime_schema.yaml +50 -0
  769. ads/opctl/operator/runtime/marketplace_runtime.py +50 -0
  770. ads/opctl/operator/runtime/python_marketplace_runtime_schema.yaml +21 -0
  771. ads/opctl/operator/runtime/python_runtime_schema.yaml +21 -0
  772. ads/opctl/operator/runtime/runtime.py +115 -0
  773. ads/opctl/schema.yaml.yml +36 -0
  774. ads/opctl/script.py +40 -0
  775. ads/opctl/spark/__init__.py +5 -0
  776. ads/opctl/spark/cli.py +43 -0
  777. ads/opctl/spark/cmds.py +147 -0
  778. ads/opctl/templates/diagnostic_report_template.jinja2 +102 -0
  779. ads/opctl/utils.py +344 -0
  780. ads/oracledb/__init__.py +5 -0
  781. ads/oracledb/oracle_db.py +346 -0
  782. ads/pipeline/__init__.py +39 -0
  783. ads/pipeline/ads_pipeline.py +2279 -0
  784. ads/pipeline/ads_pipeline_run.py +772 -0
  785. ads/pipeline/ads_pipeline_step.py +605 -0
  786. ads/pipeline/builders/__init__.py +5 -0
  787. ads/pipeline/builders/infrastructure/__init__.py +5 -0
  788. ads/pipeline/builders/infrastructure/custom_script.py +32 -0
  789. ads/pipeline/cli.py +119 -0
  790. ads/pipeline/extension.py +291 -0
  791. ads/pipeline/schema/__init__.py +5 -0
  792. ads/pipeline/schema/cs_step_schema.json +35 -0
  793. ads/pipeline/schema/ml_step_schema.json +31 -0
  794. ads/pipeline/schema/pipeline_schema.json +71 -0
  795. ads/pipeline/visualizer/__init__.py +5 -0
  796. ads/pipeline/visualizer/base.py +570 -0
  797. ads/pipeline/visualizer/graph_renderer.py +272 -0
  798. ads/pipeline/visualizer/text_renderer.py +84 -0
  799. ads/secrets/__init__.py +11 -0
  800. ads/secrets/adb.py +386 -0
  801. ads/secrets/auth_token.py +86 -0
  802. ads/secrets/big_data_service.py +365 -0
  803. ads/secrets/mysqldb.py +149 -0
  804. ads/secrets/oracledb.py +160 -0
  805. ads/secrets/secrets.py +407 -0
  806. ads/telemetry/__init__.py +7 -0
  807. ads/telemetry/base.py +69 -0
  808. ads/telemetry/client.py +122 -0
  809. ads/telemetry/telemetry.py +257 -0
  810. ads/templates/dataflow_pyspark.jinja2 +13 -0
  811. ads/templates/dataflow_sparksql.jinja2 +22 -0
  812. ads/templates/func.jinja2 +20 -0
  813. ads/templates/schemas/openapi.json +1740 -0
  814. ads/templates/score-pkl.jinja2 +173 -0
  815. ads/templates/score.jinja2 +322 -0
  816. ads/templates/score_embedding_onnx.jinja2 +202 -0
  817. ads/templates/score_generic.jinja2 +165 -0
  818. ads/templates/score_huggingface_pipeline.jinja2 +217 -0
  819. ads/templates/score_lightgbm.jinja2 +185 -0
  820. ads/templates/score_onnx.jinja2 +407 -0
  821. ads/templates/score_onnx_new.jinja2 +473 -0
  822. ads/templates/score_oracle_automl.jinja2 +185 -0
  823. ads/templates/score_pyspark.jinja2 +154 -0
  824. ads/templates/score_pytorch.jinja2 +219 -0
  825. ads/templates/score_scikit-learn.jinja2 +184 -0
  826. ads/templates/score_tensorflow.jinja2 +184 -0
  827. ads/templates/score_xgboost.jinja2 +178 -0
  828. ads/text_dataset/__init__.py +5 -0
  829. ads/text_dataset/backends.py +211 -0
  830. ads/text_dataset/dataset.py +445 -0
  831. ads/text_dataset/extractor.py +207 -0
  832. ads/text_dataset/options.py +53 -0
  833. ads/text_dataset/udfs.py +22 -0
  834. ads/text_dataset/utils.py +49 -0
  835. ads/type_discovery/__init__.py +9 -0
  836. ads/type_discovery/abstract_detector.py +21 -0
  837. ads/type_discovery/constant_detector.py +41 -0
  838. ads/type_discovery/continuous_detector.py +54 -0
  839. ads/type_discovery/credit_card_detector.py +99 -0
  840. ads/type_discovery/datetime_detector.py +92 -0
  841. ads/type_discovery/discrete_detector.py +118 -0
  842. ads/type_discovery/document_detector.py +146 -0
  843. ads/type_discovery/ip_detector.py +68 -0
  844. ads/type_discovery/latlon_detector.py +90 -0
  845. ads/type_discovery/phone_number_detector.py +63 -0
  846. ads/type_discovery/type_discovery_driver.py +87 -0
  847. ads/type_discovery/typed_feature.py +594 -0
  848. ads/type_discovery/unknown_detector.py +41 -0
  849. ads/type_discovery/zipcode_detector.py +48 -0
  850. ads/vault/__init__.py +7 -0
  851. ads/vault/vault.py +237 -0
  852. {oracle_ads-2.13.9rc0.dist-info → oracle_ads-2.13.10.dist-info}/METADATA +150 -149
  853. oracle_ads-2.13.10.dist-info/RECORD +858 -0
  854. {oracle_ads-2.13.9rc0.dist-info → oracle_ads-2.13.10.dist-info}/WHEEL +1 -2
  855. {oracle_ads-2.13.9rc0.dist-info → oracle_ads-2.13.10.dist-info}/entry_points.txt +2 -1
  856. oracle_ads-2.13.9rc0.dist-info/RECORD +0 -9
  857. oracle_ads-2.13.9rc0.dist-info/top_level.txt +0 -1
  858. {oracle_ads-2.13.9rc0.dist-info → oracle_ads-2.13.10.dist-info}/licenses/LICENSE.txt +0 -0
@@ -0,0 +1,710 @@
1
+ #!/usr/bin/env python
2
+ # -*- coding: utf-8; -*-
3
+
4
+ # Copyright (c) 2022, 2023 Oracle and/or its affiliates.
5
+ # Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/
6
+
7
+ import copy
8
+ import json
9
+ import os
10
+ import shlex
11
+ import shutil
12
+ import tempfile
13
+ import time
14
+ from distutils import dir_util
15
+ from typing import Dict, Tuple, Union
16
+
17
+ from ads.common.auth import AuthContext, AuthType, create_signer
18
+ from ads.common.oci_client import OCIClientFactory
19
+ from ads.jobs import (
20
+ ContainerRuntime,
21
+ DataScienceJob,
22
+ DataScienceJobRun,
23
+ GitPythonRuntime,
24
+ Job,
25
+ NotebookRuntime,
26
+ PythonRuntime,
27
+ ScriptRuntime,
28
+ )
29
+ from ads.opctl import logger
30
+ from ads.opctl.backend.base import Backend, RuntimeFactory
31
+ from ads.opctl.config.resolver import ConfigResolver
32
+ from ads.opctl.constants import DEFAULT_IMAGE_SCRIPT_DIR
33
+ from ads.opctl.decorator.common import print_watch_command
34
+ from ads.opctl.distributed.common.cluster_config_helper import (
35
+ ClusterConfigToJobSpecConverter,
36
+ )
37
+ from ads.opctl.operator.common.const import ENV_OPERATOR_ARGS
38
+ from ads.opctl.operator.common.operator_loader import OperatorInfo, OperatorLoader
39
+
40
+ REQUIRED_FIELDS = [
41
+ "project_id",
42
+ "compartment_id",
43
+ "subnet_id",
44
+ "block_storage_size_in_GBs",
45
+ "shape_name",
46
+ ]
47
+
48
+
49
+ class MLJobBackend(Backend):
50
+ def __init__(self, config: Dict) -> None:
51
+ """
52
+ Initialize a MLJobBackend object given config dictionary.
53
+
54
+ Parameters
55
+ ----------
56
+ config: dict
57
+ dictionary of configurations
58
+ """
59
+ self.config = config
60
+ self.oci_auth = create_signer(
61
+ config["execution"].get("auth"),
62
+ config["execution"].get("oci_config", None),
63
+ config["execution"].get("oci_profile", None),
64
+ )
65
+ self.auth_type = config["execution"].get("auth")
66
+ self.profile = config["execution"].get("oci_profile", None)
67
+ self.client = OCIClientFactory(**self.oci_auth).data_science
68
+
69
+ def init(
70
+ self,
71
+ uri: Union[str, None] = None,
72
+ overwrite: bool = False,
73
+ runtime_type: Union[str, None] = None,
74
+ **kwargs: Dict,
75
+ ) -> Union[str, None]:
76
+ """Generates a starter YAML specification for a Data Science Job.
77
+
78
+ Parameters
79
+ ----------
80
+ overwrite: (bool, optional). Defaults to False.
81
+ Overwrites the result specification YAML if exists.
82
+ uri: (str, optional), Defaults to None.
83
+ The filename to save the resulting specification template YAML.
84
+ runtime_type: (str, optional). Defaults to None.
85
+ The resource runtime type.
86
+ **kwargs: Dict
87
+ The optional arguments.
88
+
89
+ Returns
90
+ -------
91
+ Union[str, None]
92
+ The YAML specification for the given resource if `uri` was not provided.
93
+ `None` otherwise.
94
+ """
95
+
96
+ conda_slug = (
97
+ kwargs.get(
98
+ "conda_slug", self.config["execution"].get("conda_slug", "conda_slug")
99
+ )
100
+ or ""
101
+ ).lower()
102
+
103
+ # if conda slug contains '/' then the assumption is that it is a custom conda pack
104
+ # the conda prefix needs to be added
105
+ if "/" in conda_slug:
106
+ conda_slug = os.path.join(
107
+ self.config["execution"].get(
108
+ "conda_pack_os_prefix", "oci://bucket@namespace/conda_environments"
109
+ ),
110
+ conda_slug,
111
+ )
112
+
113
+ RUNTIME_KWARGS_MAP = {
114
+ ContainerRuntime().type: {
115
+ "image": (
116
+ f"{self.config['infrastructure'].get('docker_registry','').rstrip('/')}"
117
+ f"/{kwargs.get('image_name', self.config['execution'].get('image','image:latest'))}"
118
+ )
119
+ },
120
+ ScriptRuntime().type: {"conda_slug": conda_slug},
121
+ PythonRuntime().type: {"conda_slug": conda_slug},
122
+ NotebookRuntime().type: {},
123
+ GitPythonRuntime().type: {},
124
+ }
125
+
126
+ runtime_type = runtime_type or PythonRuntime().type
127
+ with AuthContext(auth=self.auth_type, profile=self.profile):
128
+ # define a job
129
+ job = (
130
+ Job()
131
+ .with_name("{Job name. For MLflow and Operator will be auto generated}")
132
+ .with_infrastructure(
133
+ DataScienceJob(
134
+ **(self.config.get("infrastructure", {}) or {})
135
+ ).init()
136
+ )
137
+ .with_runtime(
138
+ JobRuntimeFactory.get_runtime(key=runtime_type).init(
139
+ **{**kwargs, **RUNTIME_KWARGS_MAP[runtime_type]}
140
+ )
141
+ )
142
+ )
143
+
144
+ note = (
145
+ "# This YAML specification was auto generated by the `ads opctl init` command.\n"
146
+ "# The more details about the jobs YAML specification can be found in the ADS documentation:\n"
147
+ "# https://accelerated-data-science.readthedocs.io/en/latest/user_guide/jobs/index.html \n\n"
148
+ )
149
+
150
+ return job.to_yaml(
151
+ uri=uri,
152
+ overwrite=overwrite,
153
+ note=note,
154
+ filter_by_attribute_map=True,
155
+ **kwargs,
156
+ )
157
+
158
+ @print_watch_command
159
+ def apply(self) -> Dict:
160
+ """
161
+ Create Job and Job Run from YAML.
162
+ """
163
+ with AuthContext(auth=self.auth_type, profile=self.profile):
164
+ job = Job.from_dict(self.config)
165
+ job.create()
166
+ job_run = job.run()
167
+ print("JOB OCID:", job.id)
168
+ print("JOB RUN OCID:", job_run.id)
169
+ return {"job_id": job.id, "run_id": job_run.id}
170
+
171
+ @print_watch_command
172
+ def run(self) -> Dict:
173
+ """
174
+ Create Job and Job Run from OCID or cli parameters.
175
+ """
176
+ # TODO Check that this still runs smoothly for distributed
177
+ with AuthContext(auth=self.auth_type, profile=self.profile):
178
+ if self.config["execution"].get("ocid", None):
179
+ job_id = self.config["execution"]["ocid"]
180
+ run_id = (
181
+ Job.from_datascience_job(self.config["execution"]["ocid"]).run().id
182
+ )
183
+ else:
184
+ payload = self._create_payload() # create job with infrastructure
185
+ src_folder = self.config["execution"].get("source_folder")
186
+ if self.config["execution"].get("conda_type") and self.config[
187
+ "execution"
188
+ ].get("conda_slug"):
189
+ # add conda runtime
190
+ job_id, run_id = self._run_with_conda_pack(payload, src_folder)
191
+ elif self.config["execution"].get("image"):
192
+ # add docker image runtime
193
+ job_id, run_id = self._run_with_image(payload)
194
+ else:
195
+ raise ValueError(
196
+ "Either conda info or image name should be provided."
197
+ )
198
+ print("JOB OCID:", job_id)
199
+ print("JOB RUN OCID:", run_id)
200
+ return {"job_id": job_id, "run_id": run_id}
201
+
202
+ def delete(self):
203
+ """
204
+ Delete Job or Job Run from OCID.
205
+ """
206
+ if self.config["execution"].get("id"):
207
+ job_id = self.config["execution"]["id"]
208
+ with AuthContext(auth=self.auth_type, profile=self.profile):
209
+ Job.from_datascience_job(job_id).delete()
210
+ print(f"Job {job_id} has been deleted.")
211
+ elif self.config["execution"].get("run_id"):
212
+ run_id = self.config["execution"]["run_id"]
213
+ with AuthContext(auth=self.auth_type, profile=self.profile):
214
+ DataScienceJobRun.from_ocid(run_id).delete()
215
+ print(f"Job run {run_id} has been deleted.")
216
+
217
+ def cancel(self):
218
+ """
219
+ Cancel Job Run from OCID.
220
+ """
221
+ with AuthContext(auth=self.auth_type, profile=self.profile):
222
+ wait_for_completion = self.config["execution"].get("wait_for_completion")
223
+ if self.config["execution"].get("id"):
224
+ id = self.config["execution"]["id"]
225
+ Job.from_datascience_job(id).cancel(
226
+ wait_for_completion=wait_for_completion
227
+ )
228
+ if wait_for_completion:
229
+ print(f"All job runs under {id} have been cancelled.")
230
+ elif self.config["execution"].get("run_id"):
231
+ run_id = self.config["execution"]["run_id"]
232
+ DataScienceJobRun.from_ocid(run_id).cancel(
233
+ wait_for_completion=wait_for_completion
234
+ )
235
+ if wait_for_completion:
236
+ print(f"Job run {run_id} has been cancelled.")
237
+
238
+ def watch(self):
239
+ """
240
+ Watch Job Run from OCID.
241
+ """
242
+ run_id = self.config["execution"]["run_id"]
243
+ interval = self.config["execution"].get("interval")
244
+ wait = self.config["execution"].get("wait")
245
+ with AuthContext(auth=self.auth_type, profile=self.profile):
246
+ run = DataScienceJobRun.from_ocid(run_id)
247
+ run.watch(interval=interval, wait=wait)
248
+
249
+ def _create_payload(self, infra=None, name=None) -> Job:
250
+ if not infra:
251
+ infra = self.config.get("infrastructure", {})
252
+ # if any(k not in infra for k in REQUIRED_FIELDS):
253
+ # missing = [k for k in REQUIRED_FIELDS if k not in infra]
254
+ # raise ValueError(
255
+ # f"Following fields are missing but are required for OCI ML Jobs: {missing}. Please run `ads opctl configure`."
256
+ # )
257
+
258
+ ml_job = DataScienceJob(spec=infra if "spec" not in infra else infra["spec"])
259
+
260
+ log_group_id = infra.get("log_group_id")
261
+ log_id = infra.get("log_id")
262
+
263
+ if log_group_id:
264
+ ml_job.with_log_group_id(log_group_id)
265
+ if log_id:
266
+ ml_job.with_log_id(log_id)
267
+ if not name:
268
+ try:
269
+ name = infra.get("displayName") or self.config["execution"].get(
270
+ "job_name"
271
+ )
272
+ except:
273
+ pass
274
+
275
+ return Job(
276
+ name=name,
277
+ infrastructure=ml_job,
278
+ )
279
+
280
+ def _run_with_conda_pack(self, payload: Job, src_folder: str) -> Tuple[str, str]:
281
+ payload.with_runtime(
282
+ ScriptRuntime().with_environment_variable(
283
+ **self.config["execution"]["env_vars"]
284
+ )
285
+ )
286
+ if self.config["execution"].get("conda_type") == "service":
287
+ payload.runtime.with_service_conda(self.config["execution"]["conda_slug"])
288
+ else:
289
+ payload.runtime.with_custom_conda(self.config["execution"]["conda_uri"])
290
+
291
+ if ConfigResolver(self.config)._is_ads_operator():
292
+ with tempfile.TemporaryDirectory() as td:
293
+ os.makedirs(os.path.join(td, "operators"), exist_ok=True)
294
+ dir_util.copy_tree(
295
+ src_folder,
296
+ os.path.join(td, "operators", os.path.basename(src_folder)),
297
+ )
298
+ curr_dir = os.path.dirname(os.path.abspath(__file__))
299
+ shutil.copy(
300
+ os.path.join(curr_dir, "..", "operators", "run.py"),
301
+ os.path.join(td, "operators"),
302
+ )
303
+ payload.runtime.with_source(
304
+ os.path.join(td, "operators"), entrypoint="operators/run.py"
305
+ )
306
+ payload.runtime.set_spec(
307
+ "args", shlex.split(self.config["execution"]["command"] + " -r")
308
+ )
309
+ job = payload.create()
310
+ job_id = job.id
311
+ run_id = job.run().id
312
+ else:
313
+ with tempfile.TemporaryDirectory() as td:
314
+ dir_util.copy_tree(
315
+ src_folder, os.path.join(td, os.path.basename(src_folder))
316
+ )
317
+ payload.runtime.with_source(
318
+ os.path.normpath(os.path.join(td, os.path.basename(src_folder))),
319
+ entrypoint=os.path.join(
320
+ os.path.basename(src_folder),
321
+ self.config["execution"]["entrypoint"],
322
+ ),
323
+ )
324
+ if self.config["execution"].get("command"):
325
+ payload.runtime.set_spec(
326
+ "args", shlex.split(self.config["execution"]["command"])
327
+ )
328
+ job = payload.create()
329
+ job_id = job.id
330
+ run_id = job.run().id
331
+ return job_id, run_id
332
+
333
+ def _run_with_image(self, payload: Job) -> Tuple[str, str]:
334
+ payload.with_runtime(
335
+ ContainerRuntime().with_environment_variable(
336
+ **self.config["execution"]["env_vars"]
337
+ )
338
+ )
339
+ image = self.config["execution"]["image"]
340
+ if ":" not in image:
341
+ image += ":latest"
342
+ payload.runtime.with_image(image)
343
+ if os.path.basename(image) == image:
344
+ logger.warn("Did you include registry in image name?")
345
+
346
+ if ConfigResolver(self.config)._is_ads_operator():
347
+ command = f"python {os.path.join(DEFAULT_IMAGE_SCRIPT_DIR, 'operators/run.py')} -r "
348
+ else:
349
+ command = ""
350
+ # running a non-operator image
351
+ if self.config["execution"].get("entrypoint"):
352
+ payload.runtime.with_entrypoint(self.config["execution"]["entrypoint"])
353
+
354
+ if self.config["execution"].get("command"):
355
+ command += f"{self.config['execution']['command']}"
356
+ if len(command) > 0:
357
+ payload.runtime.with_cmd(",".join(shlex.split(command)))
358
+
359
+ job = payload.create()
360
+ job_id = job.id
361
+ run_id = job.run().id
362
+ return job_id, run_id
363
+
364
+
365
+ class MLJobDistributedBackend(MLJobBackend):
366
+ DIAGNOSTIC_COMMAND = "python -m ads.opctl.diagnostics -t distributed"
367
+
368
+ def __init__(self, config: Dict) -> None:
369
+ """
370
+ Initialize a MLJobDistributedBackend object given config dictionary.
371
+
372
+ Parameters
373
+ ----------
374
+ config: dict
375
+ dictionary of configurations
376
+ """
377
+ super().__init__(config=config)
378
+ self.job = None
379
+
380
+ def prepare_job_config(self, cluster_info):
381
+ job_conf_helper = ClusterConfigToJobSpecConverter(cluster_info)
382
+ jobdef_conf = job_conf_helper.job_def_info()
383
+ infrastructure = cluster_info.infrastructure
384
+ if jobdef_conf.get("name"):
385
+ infrastructure["spec"]["displayName"] = jobdef_conf.get("name")
386
+ job = self._create_payload(infrastructure["spec"])
387
+ envVars = {}
388
+ envVars.update(
389
+ cluster_info.cluster.config.envVars
390
+ ) # Add user provided environment variables
391
+ envVars.update(
392
+ jobdef_conf.get("envVars") or {}
393
+ ) # Update with `OCI__` environment variables
394
+
395
+ job.with_runtime(ContainerRuntime().with_environment_variable(**envVars))
396
+ job.runtime.with_image(image=jobdef_conf["image"])
397
+ self.job = job
398
+ if os.path.basename(jobdef_conf["image"]) == jobdef_conf["image"]:
399
+ logger.warning("Did you include registry in image name?")
400
+ main_jobrun_conf = job_conf_helper.job_run_info("main")
401
+ main_jobrun_conf["envVars"]["RANK"] = "0"
402
+ main_jobrun_conf["name"] = main_jobrun_conf.get("name") or "main"
403
+
404
+ worker_jobrun_conf = job_conf_helper.job_run_info("worker")
405
+ worker_jobrun_conf_list = []
406
+ if worker_jobrun_conf:
407
+ for i in range(cluster_info.cluster.worker.replicas):
408
+ conf = copy.deepcopy(worker_jobrun_conf)
409
+ conf["envVars"]["RANK"] = str(i + 1)
410
+ conf["name"] = (
411
+ conf.get("name", worker_jobrun_conf["envVars"]["OCI__MODE"])
412
+ + "_"
413
+ + str(i)
414
+ )
415
+ worker_jobrun_conf_list.append(conf)
416
+ ps_jobrun_conf = job_conf_helper.job_run_info("ps")
417
+ ps_jobrun_conf_list = []
418
+ if ps_jobrun_conf:
419
+ for i in range(cluster_info.cluster.ps.replicas):
420
+ conf = copy.deepcopy(ps_jobrun_conf)
421
+ conf["name"] = (
422
+ conf.get("name", worker_jobrun_conf["envVars"]["OCI__MODE"])
423
+ + "_"
424
+ + str(i)
425
+ )
426
+ ps_jobrun_conf_list.append(conf)
427
+
428
+ worker_jobrun_conf_list.extend(ps_jobrun_conf_list)
429
+ return main_jobrun_conf, worker_jobrun_conf_list
430
+
431
+ @staticmethod
432
+ def generate_worker_name(worker_jobrun_conf, i):
433
+ return f"{worker_jobrun_conf['name']}-{i}"
434
+
435
+ def run_diagnostics(self, cluster_info, dry_run=False, **kwargs):
436
+ with AuthContext(auth=self.auth_type, profile=self.profile):
437
+ main_jobrun_conf, worker_jobrun_conf_list = self.prepare_job_config(
438
+ cluster_info=cluster_info
439
+ )
440
+ self.job.runtime.with_entrypoint(["/bin/bash", "--login", "-c"])
441
+ self.job.runtime.with_cmd(MLJobDistributedBackend.DIAGNOSTIC_COMMAND)
442
+ if dry_run: # If dry run, print the job yaml on the console.
443
+ print(
444
+ "-----------------------------Entering dryrun mode----------------------------------"
445
+ )
446
+ print(f"Creating Job with payload: \n{self.job}")
447
+ print("+" * 200)
448
+
449
+ print(f"Creating Main Job Run with following details:")
450
+ print(f"Name: {main_jobrun_conf['name']}")
451
+ print(f"Additional Environment Variables: ")
452
+ main_env_Vars = main_jobrun_conf.get("envVars", {})
453
+ for k in main_env_Vars:
454
+ print(f"\t{k}:{main_env_Vars[k]}")
455
+ print("~" * 200)
456
+
457
+ print(
458
+ "-----------------------------Ending dryrun mode----------------------------------"
459
+ )
460
+ return None
461
+ else:
462
+ job = self.job.create()
463
+
464
+ # Start main job
465
+ conf = dict(main_jobrun_conf)
466
+ main_jobrun = job.run(
467
+ conf["name"],
468
+ env_var=conf["envVars"],
469
+ # freeform_tags={"distributed_training": "oracle-ads"},
470
+ )
471
+ self.job = job
472
+ main_jobrun.watch()
473
+ return job, main_jobrun
474
+
475
+ def run(self, cluster_info, dry_run=False) -> None:
476
+ """
477
+ * Creates Job Definition and starts main and worker jobruns from that job definition
478
+ * The Job Definition will contain all the environment variables defined at the cluster/spec/config level, environment variables defined by the user at runtime/spec/env level and `OCI__` derived from the yaml specification
479
+ * The Job Run will have overrides provided by the user under cluster/spec/{main|worker}/config section and `OCI__MODE`={MASTER|WORKER} depending on the run type
480
+ """
481
+ with AuthContext(auth=self.auth_type, profile=self.profile):
482
+ main_jobrun_conf, worker_jobrun_conf_list = self.prepare_job_config(
483
+ cluster_info=cluster_info
484
+ )
485
+ if dry_run: # If dry run, print the job yaml on the console.
486
+ print(
487
+ "-----------------------------Entering dryrun mode----------------------------------"
488
+ )
489
+ print(f"Creating Job with payload: \n{self.job}")
490
+ print(
491
+ "++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++"
492
+ )
493
+
494
+ print(f"Creating Main Job Run with following details:")
495
+ print(f"Name: {main_jobrun_conf['name']}")
496
+ print(f"Additional Environment Variables: ")
497
+ main_env_Vars = main_jobrun_conf.get("envVars", {})
498
+ for k in main_env_Vars:
499
+ print(f"\t{k}:{main_env_Vars[k]}")
500
+ print(
501
+ "~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"
502
+ )
503
+ if cluster_info.cluster.worker:
504
+ print(f"Creating Job Runs with following details:")
505
+ for i in range(len(worker_jobrun_conf_list)):
506
+ worker_jobrun_conf = worker_jobrun_conf_list[i]
507
+ print("Name: " + worker_jobrun_conf.get("name"))
508
+ print("Additional Environment Variables: ")
509
+ worker_env_Vars = worker_jobrun_conf.get("envVars", {})
510
+ for k in worker_env_Vars:
511
+ print(f"\t{k}:{worker_env_Vars[k]}")
512
+
513
+ print(
514
+ "-----------------------------Ending dryrun mode----------------------------------"
515
+ )
516
+ return None
517
+
518
+ else:
519
+ job = self.job.create()
520
+
521
+ # Start main job
522
+ conf = dict(main_jobrun_conf)
523
+ main_jobrun = job.run(
524
+ conf["name"],
525
+ env_var=conf["envVars"],
526
+ # freeform_tags={"distributed_training": "oracle-ads"},
527
+ )
528
+
529
+ # Start worker job
530
+ worker_jobruns = []
531
+ if cluster_info.cluster.worker:
532
+ for i in range(len(worker_jobrun_conf_list)):
533
+ worker_jobrun_conf = worker_jobrun_conf_list[i]
534
+ conf = dict(worker_jobrun_conf)
535
+ jobrun = job.run(
536
+ worker_jobrun_conf.get("name"),
537
+ env_var=conf["envVars"],
538
+ )
539
+ worker_jobruns.append(jobrun)
540
+ self.job = job
541
+ return job, main_jobrun, worker_jobruns
542
+
543
+
544
+ class MLJobOperatorBackend(MLJobBackend):
545
+ """
546
+ Backend class to run operator on Data Science Jobs.
547
+ Currently supported two scenarios:
548
+ * Running operator within container runtime.
549
+ * Running operator within python runtime.
550
+
551
+ Attributes
552
+ ----------
553
+ runtime_config: (Dict)
554
+ The runtime config for the operator.
555
+ operator_config: (Dict)
556
+ The operator specification config.
557
+ operator_type: str
558
+ The type of the operator.
559
+ operator_version: str
560
+ The version of the operator.
561
+ operator_info: OperatorInfo
562
+ The detailed information about the operator.
563
+ job: Job
564
+ The Data Science Job.
565
+ """
566
+
567
+ def __init__(self, config: Dict, operator_info: OperatorInfo = None) -> None:
568
+ """
569
+ Instantiates the operator backend.
570
+
571
+ Parameters
572
+ ----------
573
+ config: (Dict)
574
+ The configuration file containing operator's specification details and execution section.
575
+ operator_info: (OperatorInfo, optional)
576
+ The operator's detailed information extracted from the operator.__init__ file.
577
+ Will be extracted from the operator type in case if not provided.
578
+ """
579
+ super().__init__(config=config or {})
580
+
581
+ self.job = None
582
+
583
+ self.runtime_config = self.config.get("runtime", {})
584
+ self.operator_config = {
585
+ **{
586
+ key: value
587
+ for key, value in self.config.items()
588
+ if key not in ("runtime", "infrastructure", "execution")
589
+ }
590
+ }
591
+ self.operator_type = self.operator_config.get("type", "unknown")
592
+ self.operator_version = self.operator_config.get("version", "unknown")
593
+
594
+ # registering supported runtime adjusters
595
+ self._RUNTIME_MAP = {
596
+ ContainerRuntime().type: self._adjust_container_runtime,
597
+ PythonRuntime().type: self._adjust_python_runtime,
598
+ }
599
+
600
+ self.operator_info = operator_info
601
+
602
+ def _adjust_common_information(self):
603
+ """Adjusts common information of the job."""
604
+
605
+ if self.job.name.lower().startswith("{job"):
606
+ self.job.with_name(
607
+ f"job_{self.operator_info.type.lower()}"
608
+ f"_{self.operator_version.lower()}"
609
+ )
610
+ self.job.runtime.with_maximum_runtime_in_minutes(
611
+ self.config["execution"].get("max_wait_time", 1200)
612
+ )
613
+
614
+ def _adjust_container_runtime(self):
615
+ """Adjusts container runtime."""
616
+ entrypoint = self.job.runtime.entrypoint
617
+ image = self.job.runtime.image.lower()
618
+ cmd = " ".join(
619
+ [
620
+ "python3",
621
+ "-m",
622
+ f"{self.operator_info.type}",
623
+ ]
624
+ )
625
+ self.job.runtime.with_environment_variable(
626
+ **{
627
+ "OCI_IAM_TYPE": AuthType.RESOURCE_PRINCIPAL,
628
+ "OCIFS_IAM_TYPE": AuthType.RESOURCE_PRINCIPAL,
629
+ ENV_OPERATOR_ARGS: json.dumps(self.operator_config),
630
+ **(self.job.runtime.envs or {}),
631
+ }
632
+ )
633
+ self.job.runtime.with_image(image=image, entrypoint=entrypoint, cmd=cmd)
634
+
635
+ def _adjust_python_runtime(self):
636
+ """Adjusts python runtime."""
637
+ temp_dir = tempfile.mkdtemp()
638
+ logger.debug(f"Copying operator's code to the temporary folder: {temp_dir}")
639
+
640
+ # prepare run.sh file to run the operator's code
641
+ script_file = os.path.join(
642
+ temp_dir, f"{self.operator_info.type}_{int(time.time())}_run.sh"
643
+ )
644
+ with open(script_file, "w") as fp:
645
+ fp.write(f"python3 -m {self.operator_info.type}")
646
+
647
+ # copy the operator's source code to the temporary folder
648
+ shutil.copytree(
649
+ self.operator_info.path.rstrip("/"),
650
+ os.path.join(temp_dir, self.operator_info.type),
651
+ dirs_exist_ok=True,
652
+ )
653
+
654
+ # prepare jobs runtime
655
+ self.job.runtime.with_source(
656
+ temp_dir,
657
+ entrypoint=os.path.basename(script_file),
658
+ ).with_working_dir(
659
+ os.path.basename(temp_dir.rstrip("/"))
660
+ ).with_environment_variable(
661
+ **{
662
+ "OCI_IAM_TYPE": AuthType.RESOURCE_PRINCIPAL,
663
+ "OCIFS_IAM_TYPE": AuthType.RESOURCE_PRINCIPAL,
664
+ ENV_OPERATOR_ARGS: json.dumps(self.operator_config),
665
+ **(self.job.runtime.envs or {}),
666
+ }
667
+ )
668
+
669
+ @print_watch_command
670
+ def run(self, **kwargs: Dict) -> Union[Dict, None]:
671
+ """
672
+ Runs the operator on the Data Science Jobs.
673
+ """
674
+ if not self.operator_info:
675
+ self.operator_info = OperatorLoader.from_uri(self.operator_type).load()
676
+
677
+ self.job = Job.from_dict(self.runtime_config).build()
678
+
679
+ # adjust job's common information
680
+ self._adjust_common_information()
681
+
682
+ # adjust runtime information
683
+ self._RUNTIME_MAP.get(self.job.runtime.type, lambda: None)()
684
+
685
+ # run the job if only it is not a dry run mode
686
+ if not self.config["execution"].get("dry_run"):
687
+ job = self.job.create()
688
+ logger.info(f"{'*' * 50}Job{'*' * 50}")
689
+ logger.info(job)
690
+
691
+ job_run = job.run()
692
+ logger.info(f"{'*' * 50}JobRun{'*' * 50}")
693
+ logger.info(job_run)
694
+
695
+ return {"job_id": job.id, "run_id": job_run.id}
696
+ else:
697
+ logger.info(f"{'*' * 50} Job (Dry Run Mode) {'*' * 50}")
698
+ logger.info(self.job)
699
+
700
+
701
+ class JobRuntimeFactory(RuntimeFactory):
702
+ """Job runtime factory."""
703
+
704
+ _MAP = {
705
+ ContainerRuntime().type: ContainerRuntime,
706
+ ScriptRuntime().type: ScriptRuntime,
707
+ PythonRuntime().type: PythonRuntime,
708
+ NotebookRuntime().type: NotebookRuntime,
709
+ GitPythonRuntime().type: GitPythonRuntime,
710
+ }