Package software.amazon.awscdk.services.glue.alpha

Class ExternalTable

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.Resource

software.amazon.awscdk.services.glue.alpha.TableBase

software.amazon.awscdk.services.glue.alpha.ExternalTable

All Implemented Interfaces:

IResource, ITable, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable

@Generated(value="jsii-pacmak/1.113.0 (build fc68b25)",
           date="2025-10-14T12:28:23.498Z")
@Stability(Experimental)
public class ExternalTable
extends TableBase

(experimental) A Glue table that targets an external data location (e.g. A table in a Redshift Cluster).

Example:

 Connection myConnection;
 Database myDatabase;
 ExternalTable.Builder.create(this, "MyTable")
         .connection(myConnection)
         .externalDataLocation("default_db_public_example") // A table in Redshift
         // ...
         .database(myDatabase)
         .columns(List.of(Column.builder()
                 .name("col1")
                 .type(Schema.STRING)
                 .build()))
         .dataFormat(DataFormat.JSON)
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	ExternalTable.Builder	(experimental) A fluent builder for ExternalTable.

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.constructs.IConstruct

software.constructs.IConstruct.Jsii$Default

Nested classes/interfaces inherited from interface software.amazon.awscdk.IResource

IResource.Jsii$Default

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.glue.alpha.ITable

ITable.Jsii$Default

Field Summary

Fields

Modifier and Type	Field	Description
static final String	PROPERTY_INJECTION_ID	(experimental) Uniquely identifies this class.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	ExternalTable(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	ExternalTable(software.amazon.jsii.JsiiObjectRef objRef)
	ExternalTable(software.constructs.Construct scope, String id, ExternalTableProps props)

Method Summary

Modifier and Type	Method	Description
IConnection	getConnection()	(experimental) The connection associated to this table.
List<PartitionIndex>	getPartitionIndexes()	(experimental) This table's partition indexes.
String	getTableArn()	(experimental) ARN of this table.
String	getTableName()	(experimental) Name of this table.
protected CfnTable	getTableResource()
Grant	grantRead(IGrantable grantee)	(experimental) Grant read permissions to the table.
Grant	grantReadWrite(IGrantable grantee)	(experimental) Grant read and write permissions to the table.
Grant	grantWrite(IGrantable grantee)	(experimental) Grant write permissions to the table.

Methods inherited from class software.amazon.awscdk.services.glue.alpha.TableBase

addPartitionIndex, fromTableArn, fromTableAttributes, getColumns, getCompressed, getDatabase, getDataFormat, getParameters, getPartitionKeys, getStorageParameters, grant, grantToUnderlyingResources

Methods inherited from class software.amazon.awscdk.Resource

applyRemovalPolicy, generatePhysicalName, getEnv, getPhysicalName, getResourceArnAttribute, getResourceNameAttribute, getStack, isOwnedResource, isResource

Methods inherited from class software.constructs.Construct

getNode, isConstruct, toString

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.constructs.IConstruct

getNode

Methods inherited from interface software.amazon.awscdk.IResource

applyRemovalPolicy, getEnv, getStack

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Field Details

PROPERTY_INJECTION_ID

@Stability(Experimental)
public static final String PROPERTY_INJECTION_ID

(experimental) Uniquely identifies this class.

Constructor Details

ExternalTable

protected ExternalTable(software.amazon.jsii.JsiiObjectRef objRef)

ExternalTable

protected ExternalTable(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

ExternalTable

@Stability(Experimental)
public ExternalTable(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @NotNull
 ExternalTableProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Details

grantRead

@Stability(Experimental)
@NotNull
public Grant grantRead(@NotNull
 IGrantable grantee)

(experimental) Grant read permissions to the table.

Specified by:

grantRead in class TableBase

Parameters:

grantee - the principal. This parameter is required.

grantReadWrite

@Stability(Experimental)
@NotNull
public Grant grantReadWrite(@NotNull
 IGrantable grantee)

(experimental) Grant read and write permissions to the table.

Specified by:

grantReadWrite in class TableBase

Parameters:

grantee - the principal. This parameter is required.

grantWrite

@Stability(Experimental)
@NotNull
public Grant grantWrite(@NotNull
 IGrantable grantee)

(experimental) Grant write permissions to the table.

Specified by:

grantWrite in class TableBase

Parameters:

grantee - the principal. This parameter is required.

getConnection

@Stability(Experimental)
@NotNull
public IConnection getConnection()

(experimental) The connection associated to this table.

getTableArn

@Stability(Experimental)
@NotNull
public String getTableArn()

(experimental) ARN of this table.

Specified by:

getTableArn in interface ITable

Specified by:

getTableArn in class TableBase

getTableName

@Stability(Experimental)
@NotNull
public String getTableName()

(experimental) Name of this table.

Specified by:

getTableName in interface ITable

Specified by:

getTableName in class TableBase

getTableResource

@Stability(Experimental)
@NotNull
protected CfnTable getTableResource()

Specified by:

getTableResource in class TableBase

getPartitionIndexes

@Stability(Experimental)
@Nullable
public List<PartitionIndex> getPartitionIndexes()

(experimental) This table's partition indexes.

Specified by:

getPartitionIndexes in class TableBase