> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kinetica.com/llms.txt
> Use this file to discover all available pages before exploring further.

# append_records

[Source](https://github.com/kineticadb/kinetica-api-rust/blob/master/crates/gpudb-api/src/generated/append_records.rs#L35-L48)
pub async fn [append\_records](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/append-records.md#method.append_records)( \&self, table\_name: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), source\_table\_name: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), field\_map: [HashMap](https://doc.rust-lang.org/1.98.1/std/collections/hash/map/struct.HashMap.html)\<[String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html)>, ) -> [Result](https://doc.rust-lang.org/1.98.1/core/result/enum.Result.html)\<[AppendRecordsResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.AppendRecordsResponse.md), [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

Append records from a source table to a target table based on the field mapAppend (or insert) all records from a source table (specified by `source_table_name`) to a particular target table (specified by `table_name`). The field map (specified by `field_map`) holds the user specified map of target table column names with their mapped source column names.

##### Arguments

<ul>
  <li>`table_name` - The table name for the records to be appended, in \[schema\_name.]table\_name format, using standard name resolution rules. Must be an existing table.</li>
  <li>`source_table_name` - The source table name to get records from, in \[schema\_name.]table\_name format, using standard name resolution rules. Must be an existing table name.</li>
  <li>`field_map` - Contains the mapping of column names from the target table (specified by `table_name`) as the keys, and corresponding column names or expressions (e.g., ‘col\_name+1’) from the source table (specified by `source_table_name`). Must be existing column names in source table and target table, and their types must be matched. For details on using expressions, see Expressions.</li>
</ul>

[Source](https://github.com/kineticadb/kinetica-api-rust/blob/master/crates/gpudb-api/src/generated/append_records.rs#L75-L95)
pub async fn [append\_records\_with\_opts](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/append-records.md#method.append_records_with_opts)( \&self, table\_name: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), source\_table\_name: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), field\_map: [HashMap](https://doc.rust-lang.org/1.98.1/std/collections/hash/map/struct.HashMap.html)\<[String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html)>, options: [AppendRecordsRequestOptions](https://docs.kinetica.com/content/api/rust/generated/api/struct.AppendRecordsRequestOptions.md), ) -> [Result](https://doc.rust-lang.org/1.98.1/core/result/enum.Result.html)\<[AppendRecordsResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.AppendRecordsResponse.md), [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

Append records from a source table to a target table based on the field mapAppend (or insert) all records from a source table (specified by `source_table_name`) to a particular target table (specified by `table_name`). The field map (specified by `field_map`) holds the user specified map of target table column names with their mapped source column names.

##### Arguments

<ul>
  <li>`table_name` - The table name for the records to be appended, in \[schema\_name.]table\_name format, using standard name resolution rules. Must be an existing table.</li>
  <li>`source_table_name` - The source table name to get records from, in \[schema\_name.]table\_name format, using standard name resolution rules. Must be an existing table name.</li>
  <li>`field_map` - Contains the mapping of column names from the target table (specified by `table_name`) as the keys, and corresponding column names or expressions (e.g., ‘col\_name+1’) from the source table (specified by `source_table_name`). Must be existing column names in source table and target table, and their types must be matched. For details on using expressions, see Expressions.</li>
  <li>`options` - The optional parameters; any left unset take the server’s defaults.</li>
</ul>

[Source](https://github.com/kineticadb/kinetica-api-rust/blob/master/crates/gpudb-api/src/generated/append_records.rs#L98-L109)
pub async fn [append\_records\_raw](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/append-records.md#method.append_records_raw)( \&self, request: &[AppendRecordsRequest](https://docs.kinetica.com/content/api/rust/generated/api/struct.AppendRecordsRequest.md), ) -> [Result](https://doc.rust-lang.org/1.98.1/core/result/enum.Result.html)\<[AppendRecordsResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.AppendRecordsResponse.md), [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

Sends a pre-built [`AppendRecordsRequest`](https://docs.kinetica.com/content/api/rust/generated/api/struct.AppendRecordsRequest) to the `/append/records` endpoint.

[Source](https://github.com/kineticadb/kinetica-api-rust/blob/master/crates/gpudb-api/src/generated/append_records.rs#L113-L125)
pub async fn [append\_records\_from\_url](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/append-records.md#method.append_records_from_url)( \&self, url: &[str](https://doc.rust-lang.org/1.98.1/std/primitive.str.html), request: &[AppendRecordsRequest](https://docs.kinetica.com/content/api/rust/generated/api/struct.AppendRecordsRequest.md), ) -> [Result](https://doc.rust-lang.org/1.98.1/core/result/enum.Result.html)\<[AppendRecordsResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.AppendRecordsResponse.md), [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

Sends a pre-built [`AppendRecordsRequest`](https://docs.kinetica.com/content/api/rust/generated/api/struct.AppendRecordsRequest) to a specific worker URL, bypassing HA head-node selection. Used for multi-head access.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.