row0ins.h

Go to the documentation of this file.

/*****************************************************************************

Copyright (c) 1996, 2012, Oracle and/or its affiliates. All Rights Reserved.

This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation; version 2 of the License.

This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Suite 500, Boston, MA 02110-1335 USA

*****************************************************************************/

/**************************************************/
#ifndef row0ins_h
#define row0ins_h

#include "univ.i"
#include "data0data.h"
#include "que0types.h"
#include "dict0types.h"
#include "trx0types.h"
#include "row0types.h"

/***************************************************************/
UNIV_INTERN
dberr_t
row_ins_check_foreign_constraint(
/*=============================*/
        ibool           check_ref,
        dict_foreign_t* foreign,
        dict_table_t*   table,  
        dtuple_t*       entry,  
        que_thr_t*      thr)    
        __attribute__((nonnull, warn_unused_result));
/*********************************************************************/
UNIV_INTERN
ins_node_t*
ins_node_create(
/*============*/
        ulint           ins_type,       
        dict_table_t*   table,          
        mem_heap_t*     heap);          
/*********************************************************************/
UNIV_INTERN
void
ins_node_set_new_row(
/*=================*/
        ins_node_t*     node,   
        dtuple_t*       row);   
/***************************************************************/
UNIV_INTERN
dberr_t
row_ins_clust_index_entry_low(
/*==========================*/
        ulint           flags,  
        ulint           mode,   
        dict_index_t*   index,  
        ulint           n_uniq, 
        dtuple_t*       entry,  
        ulint           n_ext,  
        que_thr_t*      thr)    
        __attribute__((nonnull, warn_unused_result));
/***************************************************************/
UNIV_INTERN
dberr_t
row_ins_sec_index_entry_low(
/*========================*/
        ulint           flags,  
        ulint           mode,   
        dict_index_t*   index,  
        mem_heap_t*     offsets_heap,
        mem_heap_t*     heap,   
        dtuple_t*       entry,  
        trx_id_t        trx_id, 
        que_thr_t*      thr)    
        __attribute__((nonnull, warn_unused_result));
/***************************************************************/
UNIV_INTERN
dberr_t
row_ins_index_entry_big_rec_func(
/*=============================*/
        const dtuple_t*         entry,  
        const big_rec_t*        big_rec,
        ulint*                  offsets,
        mem_heap_t**            heap,   
        dict_index_t*           index,  
        const char*             file,   
#ifndef DBUG_OFF
        const void*             thd,    
#endif /* DBUG_OFF */
        ulint                   line)   
        __attribute__((nonnull(1,2,3,4,5,6), warn_unused_result));
#ifdef DBUG_OFF
# define row_ins_index_entry_big_rec(e,big,ofs,heap,index,thd,file,line) \
        row_ins_index_entry_big_rec_func(e,big,ofs,heap,index,file,line)
#else /* DBUG_OFF */
# define row_ins_index_entry_big_rec(e,big,ofs,heap,index,thd,file,line) \
        row_ins_index_entry_big_rec_func(e,big,ofs,heap,index,file,thd,line)
#endif /* DBUG_OFF */
/***************************************************************/
UNIV_INTERN
dberr_t
row_ins_clust_index_entry(
/*======================*/
        dict_index_t*   index,  
        dtuple_t*       entry,  
        que_thr_t*      thr,    
        ulint           n_ext)  
        __attribute__((nonnull, warn_unused_result));
/***************************************************************/
UNIV_INTERN
dberr_t
row_ins_sec_index_entry(
/*====================*/
        dict_index_t*   index,  
        dtuple_t*       entry,  
        que_thr_t*      thr)    
        __attribute__((nonnull, warn_unused_result));
/***********************************************************/
UNIV_INTERN
que_thr_t*
row_ins_step(
/*=========*/
        que_thr_t*      thr);   
/* Insert node structure */

struct ins_node_t{
        que_common_t    common; 
        ulint           ins_type;/* INS_VALUES, INS_SEARCHED, or INS_DIRECT */
        dtuple_t*       row;    
        dict_table_t*   table;  
        sel_node_t*     select; 
        que_node_t*     values_list;/* list of expressions to evaluate and
                                insert in an INS_VALUES insert */
        ulint           state;  
        dict_index_t*   index;  
        dtuple_t*       entry;  
        UT_LIST_BASE_NODE_T(dtuple_t)
                        entry_list;/* list of entries, one for each index */
        byte*           row_id_buf;/* buffer for the row id sys field in row */
        trx_id_t        trx_id; 
        byte*           trx_id_buf;/* buffer for the trx id sys field in row */
        mem_heap_t*     entry_sys_heap;
                                /* memory heap used as auxiliary storage;
                                entry_list and sys fields are stored here;
                                if this is NULL, entry list should be created
                                and buffers for sys fields in row allocated */
        ulint           magic_n;
};

#define INS_NODE_MAGIC_N        15849075

/* Insert node types */
#define INS_SEARCHED    0       /* INSERT INTO ... SELECT ... */
#define INS_VALUES      1       /* INSERT INTO ... VALUES ... */
#define INS_DIRECT      2       /* this is for internal use in dict0crea:
                                insert the row directly */

/* Node execution states */
#define INS_NODE_SET_IX_LOCK    1       /* we should set an IX lock on table */
#define INS_NODE_ALLOC_ROW_ID   2       /* row id should be allocated */
#define INS_NODE_INSERT_ENTRIES 3       /* index entries should be built and
                                        inserted */

#ifndef UNIV_NONINL
#include "row0ins.ic"
#endif

#endif