Skip to content

Surnames

Jonathan Bairstow edited this page Sep 8, 2020 · 1 revision

This collection of SQL artefacts can be used to randomly generate surname values, either singularly or in batches of up to 10000 values.

Reference data.

All procedures and functions described below generate values based on the values in [Reference].[surname]. It is recommended that this table be populated with prerandomised data.

This table can be populated by executing the procedure [Reference].[usp_Populate_surname]. Values can be added to, or removed from this table, but the following rules must be enforced:

  • Values for surnameSK must be continuous and have no gaps.
  • [SystemControl].[ReferenceControl] must be maintained so that the value for MaxReferenceSK accurately reflects the number of records in [Reference].[surname].

The table can be repopluated, resolving any breaches of the above rules, by executing procedure [Reference].[usp_Maintain_surname].

Procedures and functions

[SingleValue].[ufn_Get_surname]

This function will return a random surname value. As a function; this method can be used to easily assign a value to an variable, or to update a field on a table.

Example usages:

Declare	@Surname varchar(50)
Select	@Surname = [SingleValue].[ufn_Get_Surname]()
Select	@Surname

[SingleValue].[usp_Get_surname]

This procedure will return a random surname value. The generated value is returned via the output parameter @surname, and can be captured in a variable, or passed back to a calling application.

Example usages:

Declare @Surname varchar(50)
exec	SingleValue.usp_Get_Surname @Surname out
Select	@Surname

[Fountain].[usp_Get_surname]

This procedure will return the next available surname value. This method, whilst not strictly random, ensures that values are evenly allocated over time. The generated value is returned via the output parameter @surname, and can be captured in a variable, or passed back to a calling application.

Example usages:

Declare @Surname varchar(50)
exec	Fountain.usp_Get_Surname @Surname out
Select	@Surname

[BulkValue].[usp_Get_surname]

This procedure will return up to 10000 random surname values. This procedure has the following input parameter:

Parameter Data Type Default Value
@QuantityRequired smallint None

A recordset with the following structure is returned:

Field Name Data Type
surname varchar(50)

This method is useful for inserting bulk data directly in to a table, or as an ETL source.

Example Usage:

exec	[BulkValue].[usp_Get_Surname] 100

[BulkFountain].[usp_Get_surname]

This procedure will return up to 10000 surname values. This method, whilst not strictly random, ensures that values are allocated evenly over time. This procedure has the following input parameter:

Parameter Data Type Default Value
@QuantityRequired smallint None

A recordset with the following structure is returned:

Field Name Data Type
surname varchar(50)

This method is useful for inserting bulk data directly in to a table, or as an ETL source.

Example Usage:

exec BulkFountain.[usp_Get_Surname] 1000

Clone this wiki locally