airflow.providers.apache.hive.transfers.mssql_to_hive

This module contains an operator to move data from MSSQL to Hive.

Module Contents

Classes

MsSqlToHiveOperator

Moves data from Microsoft SQL Server to Hive.

class airflow.providers.apache.hive.transfers.mssql_to_hive.MsSqlToHiveOperator(*, sql, hive_table, create=True, recreate=False, partition=None, delimiter=chr(1), mssql_conn_id='mssql_default', hive_cli_conn_id='hive_cli_default', hive_auth=None, tblproperties=None, **kwargs)[source]

Bases: airflow.models.BaseOperator

Moves data from Microsoft SQL Server to Hive.

The operator runs your query against Microsoft SQL Server, stores the file locally before loading it into a Hive table. If the create or recreate arguments are set to True, a CREATE TABLE and DROP TABLE statements are generated.

Hive data types are inferred from the cursor’s metadata. Note that the table generated in Hive uses STORED AS textfile which isn’t the most efficient serialization format. If a large amount of data is loaded and/or if the table gets queried considerably, you may want to use this operator only to stage the data into a temporary table before loading it into its final destination using a HiveOperator.

Parameters
  • sql (str) – SQL query to execute against the Microsoft SQL Server database. (templated)

  • hive_table (str) – target Hive table, use dot notation to target a specific database. (templated)

  • create (bool) – whether to create the table if it doesn’t exist

  • recreate (bool) – whether to drop and recreate the table at every execution

  • partition (dict | None) – target partition as a dict of partition columns and values. (templated)

  • delimiter (str) – field delimiter in the file

  • mssql_conn_id (str) – source Microsoft SQL Server connection

  • hive_cli_conn_id (str) – Reference to the Hive CLI connection id.

  • hive_auth (str | None) – optional authentication option passed for the Hive connection

  • tblproperties (dict | None) – TBLPROPERTIES of the hive table being created

template_fields: Sequence[str] = ('sql', 'partition', 'hive_table')[source]
template_ext: Sequence[str] = ('.sql',)[source]
template_fields_renderers[source]
ui_color = '#a0e08c'[source]
classmethod type_map(mssql_type)[source]

Map MsSQL type to Hive type.

execute(context)[source]

Derive when creating an operator.

Context is the same dictionary used as when rendering jinja templates.

Refer to get_template_context for more context.

Was this entry helpful?