:doc:`Glue <../../glue>` / Client / get_column_statistics_task_settings

***********************************
get_column_statistics_task_settings
***********************************



.. py:method:: Glue.Client.get_column_statistics_task_settings(**kwargs)

  

  Gets settings for a column statistics task.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/GetColumnStatisticsTaskSettings>`_  


  **Request Syntax**
  ::

    response = client.get_column_statistics_task_settings(
        DatabaseName='string',
        TableName='string'
    )
    
  :type DatabaseName: string
  :param DatabaseName: **[REQUIRED]** 

    The name of the database where the table resides.

    

  
  :type TableName: string
  :param TableName: **[REQUIRED]** 

    The name of the table for which to retrieve column statistics.

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'ColumnStatisticsTaskSettings': {
              'DatabaseName': 'string',
              'TableName': 'string',
              'Schedule': {
                  'ScheduleExpression': 'string',
                  'State': 'SCHEDULED'|'NOT_SCHEDULED'|'TRANSITIONING'
              },
              'ColumnNameList': [
                  'string',
              ],
              'CatalogID': 'string',
              'Role': 'string',
              'SampleSize': 123.0,
              'SecurityConfiguration': 'string',
              'ScheduleType': 'CRON'|'AUTO',
              'SettingSource': 'CATALOG'|'TABLE',
              'LastExecutionAttempt': {
                  'Status': 'FAILED'|'STARTED',
                  'ColumnStatisticsTaskRunId': 'string',
                  'ExecutionTimestamp': datetime(2015, 1, 1),
                  'ErrorMessage': 'string'
              }
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **ColumnStatisticsTaskSettings** *(dict) --* 

        A ``ColumnStatisticsTaskSettings`` object representing the settings for the column statistics task.

        
        

        - **DatabaseName** *(string) --* 

          The name of the database where the table resides.

          
        

        - **TableName** *(string) --* 

          The name of the table for which to generate column statistics.

          
        

        - **Schedule** *(dict) --* 

          A schedule for running the column statistics, specified in CRON syntax.

          
          

          - **ScheduleExpression** *(string) --* 

            A ``cron`` expression used to specify the schedule (see `Time-Based Schedules for Jobs and Crawlers <https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html>`__. For example, to run something every day at 12:15 UTC, you would specify: ``cron(15 12 * * ? *)``.

            
          

          - **State** *(string) --* 

            The state of the schedule.

            
      
        

        - **ColumnNameList** *(list) --* 

          A list of column names for which to run statistics.

          
          

          - *(string) --* 
      
        

        - **CatalogID** *(string) --* 

          The ID of the Data Catalog in which the database resides.

          
        

        - **Role** *(string) --* 

          The role used for running the column statistics.

          
        

        - **SampleSize** *(float) --* 

          The percentage of data to sample.

          
        

        - **SecurityConfiguration** *(string) --* 

          Name of the security configuration that is used to encrypt CloudWatch logs.

          
        

        - **ScheduleType** *(string) --* 

          The type of schedule for a column statistics task. Possible values may be ``CRON`` or ``AUTO``.

          
        

        - **SettingSource** *(string) --* 

          The source of setting the column statistics task. Possible values may be ``CATALOG`` or ``TABLE``.

          
        

        - **LastExecutionAttempt** *(dict) --* 

          The last ``ExecutionAttempt`` for the column statistics task run.

          
          

          - **Status** *(string) --* 

            The status of the last column statistics task run.

            
          

          - **ColumnStatisticsTaskRunId** *(string) --* 

            A task run ID for the last column statistics task run.

            
          

          - **ExecutionTimestamp** *(datetime) --* 

            A timestamp when the last column statistics task run occurred.

            
          

          - **ErrorMessage** *(string) --* 

            An error message associated with the last column statistics task run.

            
      
    
  
  **Exceptions**
  
  *   :py:class:`Glue.Client.exceptions.EntityNotFoundException`

  
  *   :py:class:`Glue.Client.exceptions.InvalidInputException`

  
  *   :py:class:`Glue.Client.exceptions.OperationTimeoutException`

  