Ready to get started?

Download a free trial of the Teradata Data Provider to get started:

 Download Now

Learn more:

Teradata Icon Teradata ADO.NET Provider

Rapidly create and deploy powerful .NET applications that integrate with Teradata databases.

Automate Teradata Integration Tasks from PowerShell



Are you in search of a quick and easy way to access Teradata data from PowerShell? This article demonstrates how to utilize the Teradata Cmdlets for tasks like connecting to Teradata data, automating operations, downloading data, and more.

The CData Cmdlets for Teradata are standard PowerShell cmdlets that make it easy to accomplish data cleansing, normalization, backup, and other integration tasks by enabling real-time and bidirectional access to Teradata.

PowerShell Cmdlets or ADO.NET Provider?

The Cmdlets are not only a PowerShell interface to Teradata, but also an SQL interface; this tutorial shows how to use both to create, retrieve, update, and delete Teradata data. We also show examples of the ADO.NET equivalent, which is possible with the CData ADO.NET Provider for Teradata. To access Teradata data from other .NET applications, like LINQPad, use the CData ADO.NET Provider for Teradata.

Once you have acquired the necessary connection properties, accessing Teradata data in PowerShell can be enabled in three steps.

To connect to Teradata, provide authentication information and specify the database server name.

  • User: Set this to the username of a Teradata user.
  • Password: Set this to the password of the Teradata user.
  • DataSource: Specify the Teradata server name, DBC Name, or TDPID.
  • Port: Specify the port the server is running on.
  • Database: Specify the database name. If not specified, the default database is used.

PowerShell

  1. Install the module:

    Install-Module TeradataCmdlets
  2. Connect:

    $teradata = Connect-Teradata -User "$User" -Password "$Password" -Server "$Server" -Database "$Database"
  3. Search for and retrieve data:

    $categoryid = "5" $northwindproducts = Select-Teradata -Connection $teradata -Table "NorthwindProducts" -Where "CategoryId = `'$CategoryId`'" $northwindproducts

    You can also use the Invoke-Teradata cmdlet to execute SQL commands:

    $northwindproducts = Invoke-Teradata -Connection $teradata -Query 'SELECT * FROM NorthwindProducts WHERE CategoryId = @CategoryId' -Params @{'@CategoryId'='5'}

ADO.NET

  1. Load the provider's assembly:

    [Reflection.Assembly]::LoadFile("C:\Program Files\CData\CData ADO.NET Provider for Teradata\lib\System.Data.CData.Teradata.dll")
  2. Connect to Teradata:

    $conn= New-Object System.Data.CData.Teradata.TeradataConnection("User=myuser;Password=mypassword;Server=localhost;Database=mydatabase;") $conn.Open()
  3. Instantiate the TeradataDataAdapter, execute an SQL query, and output the results:

    $sql="SELECT ProductId, ProductName from NorthwindProducts" $da= New-Object System.Data.CData.Teradata.TeradataDataAdapter($sql, $conn) $dt= New-Object System.Data.DataTable $da.Fill($dt) $dt.Rows | foreach { Write-Host $_.productid $_.productname }

Update Teradata Data

PowerShell

Update-Teradata -Connection $Teradata -Columns @('ProductId','ProductName') -Values @('MyProductId', 'MyProductName') -Table NorthwindProducts -Id "MyId"

ADO.NET

$cmd = New-Object System.Data.CData.Teradata.TeradataCommand("UPDATE NorthwindProducts SET CategoryId='5' WHERE Id = @myId", $conn) $cmd.Parameters.Add((New-Object System.Data.CData.Teradata.TeradataParameter("@myId","10456255-0015501366"))) $cmd.ExecuteNonQuery()

Insert Teradata Data

PowerShell

Add-Teradata -Connection $Teradata -Table NorthwindProducts -Columns @("ProductId", "ProductName") -Values @("MyProductId", "MyProductName")

ADO.NET

$cmd = New-Object System.Data.CData.Teradata.TeradataCommand("INSERT INTO NorthwindProducts (CategoryId) VALUES (@myCategoryId)", $conn) $cmd.Parameters.Add((New-Object System.Data.CData.Teradata.TeradataParameter("@myCategoryId","5"))) $cmd.ExecuteNonQuery()

Delete Teradata Data

PowerShell

Remove-Teradata -Connection $Teradata -Table "NorthwindProducts" -Id "MyId"

ADO.NET

$cmd = New-Object System.Data.CData.Teradata.TeradataCommand("DELETE FROM NorthwindProducts WHERE Id=@myId", $conn) $cmd.Parameters.Add((New-Object System.Data.CData.Teradata.TeradataParameter("@myId","001d000000YBRseAAH"))) $cmd.ExecuteNonQuery()