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

********************************
start_column_statistics_task_run
********************************



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

  

  Starts a column statistics task run, for a specified table and columns.

  

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


  **Request Syntax**
  ::

    response = client.start_column_statistics_task_run(
        DatabaseName='string',
        TableName='string',
        ColumnNameList=[
            'string',
        ],
        Role='string',
        SampleSize=123.0,
        CatalogID='string',
        SecurityConfiguration='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 to generate statistics.

    

  
  :type ColumnNameList: list
  :param ColumnNameList: 

    A list of the column names to generate statistics. If none is supplied, all column names for the table will be used by default.

    

  
    - *(string) --* 

    

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

    The IAM role that the service assumes to generate statistics.

    

  
  :type SampleSize: float
  :param SampleSize: 

    The percentage of rows used to generate statistics. If none is supplied, the entire table will be used to generate stats.

    

  
  :type CatalogID: string
  :param CatalogID: 

    The ID of the Data Catalog where the table reside. If none is supplied, the Amazon Web Services account ID is used by default.

    

  
  :type SecurityConfiguration: string
  :param SecurityConfiguration: 

    Name of the security configuration that is used to encrypt CloudWatch logs for the column stats task run.

    

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

    
    ::

      {
          'ColumnStatisticsTaskRunId': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

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

        The identifier for the column statistics task run.

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

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

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

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

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

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

  