
                         P   S r SSKJr  SSKJr  SSKJr  SSKJr  SSKJr  SSK	J
r  SSKJr  SS	KJr  SS
KJr  SSKJr  SSKJr  \R*                  \R,                  " \R.                  R0                  \R.                  R2                  5       " S S\R4                  5      5       5       rg)z>`gcloud dataplex datascans create data-documentation` command.    )absolute_import)division)unicode_literals)datascan)util)
exceptions)base)resource_args)labels_util)log)
propertiesc                       \ rS rSrSr\R                  R                  R                  R                  5       rSS0r
\S 5       r\R                  " S5      S 5       rSrg	)
DataDocumentation   zuCreate a Dataplex data documentation scan job.

Allows users to generate documentation for Dataplex BigQuery tables.
EXAMPLESa  
          To create a data documentation scan `data-documentation-datascan`
          in project `test-project` located in `us-central1` on entity `test-entity`, run:

            $ {command} data-documentation-datascan --project=test-project --location=us-central1 --data-source-resource="//bigquery.{universe_domain}/projects/test-project/datasets/test-dataset/tables/test-table"

          c                    [         R                  " U S5        U R                  SSSS9  U R                  SSSS9  U R                  SSS	S
9nUR                  SSS9  UR                  SSS9  U R                  SS9nUR                  SSS9nUR                  S[        SS9  UR                  SSS9  U R                  SSSS
9nUR                  SSSSS9  [
        R                  R                  U5        [        R                  " U 5        g )Nz(to create a data documentation scan for.z--descriptionFz+Description of the data documentation scan.)requiredhelpz--display-namez,Display name of the data documentation scan.Tz,Data source for the data documentation scan.)mutexr   r   z--data-source-entityzThe Dataplex entity that contains the data for the data documentation scan, of the form: projects/{project_id_or_number}/locations/{location_id}/lakes/{lake_id}/zones/{zone_id}/entities/{entity_id}. Currently only BigQuery table is supported.)r   z--data-source-resourcezFully-qualified service resource name of the cloud resource that contains the data for the data documentation scan, of the form: //bigquery.{universe_domain}/projects/{project_id_or_number}/datasets/{dataset_id}/tables/{table_id}.z+Data documentation scan execution settings.z8Data documentation scan scheduling and trigger settings.)r   r   z--on-demandzNIf set, the scan runs one-time shortly after data documentation scan creation.)typer   z
--schedulea  Cron schedule (https://en.wikipedia.org/wiki/Cron) for running scans periodically. To explicitly set a timezone to the cron tab, apply a prefix in the cron tab: "CRON_TZ=${IANA_TIME_ZONE}" or "TZ=${IANA_TIME_ZONE}". The ${IANA_TIME_ZONE} may only be a valid string from IANA time zone database. For example, `CRON_TZ=America/New_York 1 * * * *` or `TZ=America/New_York 1 * * * *`. This field is required for RECURRING scans.z:At most one of --async | --validate-only can be specified.z--validate-only
store_truez:Validate the create action, but don't actually perform it.)actiondefaultr   )
r
   AddDatascanResourceArgadd_argument	add_groupboolr	   
ASYNC_FLAGAddToParserr   AddCreateLabelsFlags)parserdata_source_groupexecution_spectriggerasync_groups        ;lib/surface/dataplex/datascans/create/data_documentation.pyArgsDataDocumentation.Args3   s   ((: :  
 ;  
 ((; ) 
 ""; #  "" u #  %%: & N &&  ' G 	   C   ""I # K
 I	   	OO,$$V,    z-Status code: {status_code}. {status_message}.c           	      :   UR                   R                  R                  5       n[        USS5        [        R
                  " 5       nUR                  R                  [        R                  " 5       R                  UR                  5       UR                  5       R                  5       [        R                  " U5      S95      n[        USS5      (       a   [        R                   R#                  S5        g [        USS5      nU(       d[  [        R$                  " U5      n[        R&                  " UR(                  SR+                  UR,                  UR.                  5      S	9  U$ [        R                   R#                  S
R+                  X$R(                  5      5        U$ )N	scan_typeDOCUMENTATION)
dataScanIdparentgoogleCloudDataplexV1DataScanvalidate_onlyFz1Validation completed. Skipping resource creation.async_zDData documentation scan created in project [{0}] with location [{1}])detailszECreating data documentation scan with path [{0}] and operation [{1}].)CONCEPTSr   Parsesetattrdataplex_utilGetClientInstanceprojects_locations_dataScansCreateGetMessageModule/DataplexProjectsLocationsDataScansCreateRequestNameParentRelativeName GenerateDatascanForCreateRequestgetattrr   statusPrintWaitForOperationCreatedResourcenameformat
projectsIdlocationsId)selfargsdatascan_refdataplex_clientcreate_req_opr1   responses          r&   RunDataDocumentation.Run   sI    ==))//1LD+/#557O#@@GG&&(XX#((*&&(557*2*S*S+ 	Y 	
M t_e,,	jjJKT8U+F**=9h	
--vl55|7O7OP	 oJJO	00	1 r)    N)__name__
__module____qualname____firstlineno____doc__r   VALUEScoreuniverse_domainGetdetailed_helpstaticmethodr'   gcloud_exception CatchHTTPErrorRaiseHTTPExceptionrO   __static_attributes__rQ   r)   r&   r   r      sq    
 %%**::>>@/ 	- K- K-Z 445""r)   r   N)rV   
__future__r   r   r   googlecloudsdk.api_lib.dataplexr   r   r6   googlecloudsdk.api_lib.utilr   r]   googlecloudsdk.callioper	   #googlecloudsdk.command_lib.dataplexr
   $googlecloudsdk.command_lib.util.argsr   googlecloudsdk.corer   r   DefaultUniverseOnlyReleaseTracksReleaseTrackALPHAGACommandr   rQ   r)   r&   <module>rm      s    E &  ' 4 A F ( = < # * D%%++T->->-A-ABE E C Er)   